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...but this IS a Database Issue. 
We have SQL, Deductive and OOP flavours. 
< ‘) Contemplating buying an SQL server? 
2 Ct, We guide you beyond the sales talk. 


104 UMes Is Ted Walker pulling a fast one? 


His database language is strangely familiar. 


Database Jules May’s Thanks For Nothing Award. 
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The Leader in Object- 


BORLAND C++ 


& APPLICATION FRAMEWORKS 


BORLAND C++ 


‘& APPLCATION FRAMEWORKS 


BORLAND 


Professional C programmers are choosing 
objech eed C++ because they know it 
increases productivity. And the C++ they're 
choosing is from Borland. With more than 
500,000 copies of C++ shipped, Borland sets 
the standard. 


Since 1983, 
Borland has 
consistently 
provided pro- 
fessional software 
development tools to 
programmers around 
the world. Today, Borland is 

the acknowledged leader in Object-Oriented 
Programming (OOP). OOP gives you amaz- 
ing code reusability, extensibility and easier 
maintenance because applications are built 
ona basis of tested, reliable code. 


Borland C++ 3.1. 
C++ you can rely on! 


Borland® C++ is the choice of professional C 
and C++ programmers for Windows and 


THE INDUSTRY-STANDARD C++ WITH 
OBJECTWINDOWS” AND TURBO VISION” 


DOS application development. The third- 
generation C++ compiler fully supports the 
AT&T CFRONT 30 standard C++, including 
templates! And the powerful C compiler fully 
implements the ANSI C standard. 
With both compilers included you can 
program in C today and move to C++ 
when you're ready, 


A host of powerful Cc 


and C++ 
for Windows 
and DOS all 


features in 

one package! 
Borland C++ comes with an 
array of powerful yet easy- 
to-use features 


Only Borland C++ gives you the graphical 
ObjectBrowser.” So you get a visual dis- 
play of the relationships between objects, 
and can easily navigate through the classes, 
functions or variables in your code. 
The EasyWin™ Library converts standard 
DOS applications to Windows just by 
recompiling, The SpeedBar™ makes 
Windows development 
astonishingly intuitive and 
fast, employing recog- 
nizable icons to repre- 
sent your frequently 
used menu items. 
Precompiled headers give 
you quick compilation and Borland C++'s 
DPMI support lets you compile huge appli- 
cations fast. Resource Workshop allows 
you to visually create your Windows user 
interface without programming. 


Quality tools that other 

compilers can’t match 
Borland C++ also comes complete with 
all the tools that the serious professional 
developer needs. Borland’s award-winning 
Turbo Debugger’ gives you intelligent, 
interactive debugging on a single monitor. 
The Turbo Profiler™ helps you spot bot- 
tlenecks in your code to streamline your 
application’s performance. With the 
object-oriented Turbo Assembler® 
you can integrate your assembly 
language code into your 
applications quickly and 
easily. 


demanded by today’s in one package! 

omental” ? P 9 Only Borland’s C++ 
programmers, The gives you 
Windows-hosted IDE provides a superior Application Frameworks 
software development environment. Now you for DOS and Windows 


create, edit, compile and run Windows appli- 
cations all from within Windows. All resulting 
in remarkable productivity. 


Borland C++ & Application Frameworks 
slashes development time by giving you intu- 
itive, ready-made user interfaces for Windows 


*J,0. Power and Associates 1991 Computer End User Satisfaction Study for Application Software Publisher: Phase IV: Business End User Summary. Responses from Business End Users at 4,396 business sites. 
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Driented Programming 


Borland makes your transition 


Borland C++ includes # Visual ObjectBrowser that navigates through 1 

= C++ with templates, compatible with AT&T your code from C to C++ easy! 
CFRONT 3.0 # EasyWin Library for converting DOS pro- To make your transition from C to C++ as 

= ANSIC grams to Windows smooth as possible, we've created World of 

= Global optimizer, including # Resource Workshop to create a complete ObjectWindows for C++ training videotape. 
+ Global register allocation range of Windows resources UT And now you can get it FREE (retail value 

Ma leelindelobalcommenaibapemon: WinSight™ message tracking utility £49.95)! This ee video on a 
» Induction variables ® Turbo Debugger for DOS and Windows memes 2° comes comp! lete with two videos, worl 
isco at jump eptimization ® Turbo Profiler for DOS and Windows book and ese code that pensar 
nen a j # Object-oriented Turbo Assembler plug right into your program! 

Rees eases) passing ; | ui WEEK Taught by internationally recog- 

« Ten other optimizations Borland C-++- & Application Frameworks nized C++ experts, World of 

8) Kast complle speed pet bone LABS Oh eet Windows for C++ will give 

= Windows and DOS integrated piu ndins foe Winds TOP PRODUCTS . an in-depth abneaalie of 
development environments = Turbo Vision for DOS OF 1991 ht ObjectWin aba applicat = 

. ae Rose i eRe fe Fave Ie pene frame-work for Windows. Combined with 


Borland C++ & Application Frameworks, 
there is no faster, more productive way to 


and DOS. Simply plug an application frame- ObjectWindows also features Borland get up to speed on C++. 
work into your application or customize it Custom Controls that make your applica- Pah teen iat ; 
any way you wish. High-level objects are tions look great. I Jhthe i ue os aoe to C++, go 
ready to bolt on with just a few lines of code. Also included is Turbo Vision” the Sri e eneen Romane. 
Add an editor in just one line! Automatically application framework for DOS that gives 
inherit windows, dialogues, menus, mouse you capabilities similar to ObjectWindows 
support and more. for character-based pro- > CIRCLE NO, 092 
grams. Both come with full 


JDP WER source code. aan et mn a es a a | 


Borland | | ,1estitics' choice | FREE Video Training loveseat 


“Borland C++ looks set to 


= Pantoc Borland is making your move to C++ as easy as possible with a ? ecial, 
Tied , Hag sine become the de facto devel- | limited-time offer. From now until 1 October 1992, you may re tan 
in Customer ; Mi see fi opment environment for I this official form for a free World of ObjectWindows for C++ training 
Satisfaction ; ae Windows programmers.” I package. Just purchase a copy of Borland C++ & Application 
Gana Hsien US} bie TD enti NA) Frameworks through your local dealer, Then send a copy of your 
. Aldus te pecan ee I invoice and your registration card, along with this official form, to: 
‘the ObjectWindows" application f See Borland International (U.K.) Ltd. H 
he ObjectWindows" application trame- <ornede Freepost RG1571. : 
work streamlines Windows development. It cheteare Teas L Twyford, Berkshire RG10 8BR 
automates initialization and gives your appli lashes paced int I 
: } eRe: 7 release... Microsoft® hasa 1 
cations more functionality with less code. Wecretdinginsde” See your dealer today! 
— EXE magazine, 1 Or call Freefone 0800 212727 
December 1991 eS SSS aS 


BORLAND 


s the Rea. 


se fit the Real Wottdi 


- Problem: — 


To Efficiently Store 
Complex Real World 
Objects in a 
Database. 


The Relational 
Solution 


....San Francisco 
26/2/92...00++++END 


POET’s Object Oriented Solution 


"Announcing PO.E.T, the first true Object Oriented Database 
system for DOS, Windows, UNIX and NeXT, with prices starting 


The Affordable Database Solution. 

Up until now, object oriented DBMSs have 
typically only been available on high end UNIX 
machines, with prohibitive entry prices of 
$20,000++. Now you can unleash the power and 
potential of a true OODBMS in your DOS or 
Windows application, at prices starting at £249 
+VAT. 


Object Oriented DBMS v Relational 

Relational Database (RDBS) and B-Tree/ISAM 
systems require that data be portrayed as a series 
of two dimensional tables. These systems were a 
real breakthrough in their time, but software 
developers are rapidly learning that life is not a 
series of two dimensional tables. 


For example, a CAD program might have an 
array of shapes, or a DTP program might model a 
page as a series of frames which might contain 
bitmaps, paragraphs or vector drawings. 
Conventional databases have a fixed set of data 
types. And the only way they group data is in a 
table. 


All trademarks acknowledged 


from just £249" 


Object-oriented programs allow us to declare new What Should You Do? 


data types as needed, And POET stores the 
objects we create as objects. This one-to-one 
correspondence of the database desigh to its 
physical storage can realize access gains of over 
one hundred fold compared with relational 
DBMSs. POET has the speed while keeping its 
kernel small; the DOS runtime is under 256Kb. 


POET includes complete 
support for C++ inheritance 

and encapsulation, class 
dictionary with class 

versioning, optimized indexing 
and querying, object caching, 
complex operators and con- 
tainers, POET has what it takes. 


L 


Persistent Object Extended database Technology 
POET took over 20 man years to, develop by 


leading German Software house BKS. In non 
German speaking Europe itis distributed by 
Silicon River Limited, the same team that first 


popularized C and C++ in the UK by aggressively 


pricing Zortech C/C++. 


Silicon River Ltd 58-60 Beresford Street, LONDON, SE18 6BG 


Voice 081 3177777 Fax081 3167778 BBS 081 317 2310 
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This is the powerful, flexible database technology 
you have been awaiting, Now it is not only 
available, but affordable. If you will be developing 
a database application on any of the platforms 
below, then please call for a free Technical 
Overview of POET, the object oriented DBMS 
engine for the 1990s, 


Platforms Supported: 


Borland C++ (DOS or Windows) 
Microsoft C/C++ 7.0 (DOS or Windows) 
Zortech C++ 3.0 (DOS of Windows) 
LP] C++ (UNIX 386 Systems) 


HP C++ Softbench 
GNU C++ (NeXT Step) 


For your free POET Technical Overview call 


081 317 7777 
Silicon 


Riven 
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<<< SOAPBOX Geer £-/ 


Dear John 


Willie Watts views CA’s purchase of Nantucket with alarm and despondency. 


Dear Computer Associates, 

A word about Nantucket. Yes you do remember, it was the last- 
but-one acquisition that you made (or, by the time this gets into 
print, probably the last-but-four acquisition that you made). You 
see, your action has caused a lot of unease in the Clipper com- 
munity; many of the developers I have spoken to are looking for 
an opportunity to jump ship. Some must already be contemplating 
HMS Fox. If either Bor- 
land/Ashton-Tate or Micro- 
soft/Fox manages to deliver a 
half decent Windows pro- 
duct, you could find yourself 
in a full-blown rats/Titanic 
situation. 

It must be galling, CA, if 
you'll excuse me addressing 
you on first initial terms, that & 
as the Biggest Software Com- 
pany in the Universe you are 
hardly known in the small ma- 
chine market. Out of interest, 

1 looked up the packages that 
you publish. There’s Super- 
Calc, a venerable old spread- 
sheet, in its youth a full-blown 
Lotus competitor, but which 
you now knock out at &80 odd 
a throw. 

Then there’s dBFast, a Win- 
dows-based xBASE type 
thing, which (one cannot help 
suspecting) if it were any 
good should have long since 
conquered the world, given 
the demand for such a product, and the resources you must have 
available to market it. For the other packages - my source listed 
twenty-seven in all - I’m afraid that I hadn't heard of any of them. 
Not because they were all too specialist for me, CA, but simply 
because none of themare among the best-known in their category. 
(Note to other readers; you too can play this game: if | asked you 
to name as many graphics packages as you could, would one of 
them be CA-Cricket?) 

Now I’m not claiming, CA, that dear old Nantucket was a 
paragon; notable peccadilloes were the inability to deliver product 
on time (everybody suffers from vapourware, but Nantucket was 
something special - do you remember the fiasco of advertising 
Clipper 5 for about nine months before it appeared?) and the 
strange business of the ‘independent’ Clipper newsletter Compass 
for Clipper, which was secretly owned by Nantucket’s proprietor, 
Mr B Rebell. But what Nantucket did have - and I fear that you don’t 
- was a good understanding of the Clipper product and its market, 
and the approach required to make Clipper successful. 

You see, Clipper is an xBASE for techies, not for punters. In an 
age where point-and-click programming is everything, Clipper will 
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do nothing for you until you sit down and cut some code. Further- 
more, Nantucket had chosen to try to educate its users - often 
people who started programming with dBASE II - in the mysteries 
of Good Programming Practice. It introduced scoped variables, 
and a preprocessor, and, I hear - get this, CA, for a strategy which 
is either idealistic or perverse - it even considered deliberately 
making the 5.X Clipper release, the fully O-O release, non-back- 
wards compatible. The idea was 
to compel Clipper users to learn 
the joys of objects. 

What Nantucket also did with 
Clipper, which has been, I 
think, the key to its success, was 
ty Bet lots of third party help. It 
FS created a good API to Microsoft 
C and fostered relations with 
little software houses, and the 
result is that when you buy Clip- 
per now, you are also buying 
access to dozens of add-on li- 
braries and tools, some very 
fine. No other xBASE product 
touches Clipper in this respect. 

Now CA, youare theoretically 
in a position to do Clipper a lot 
of good. You can give the devel- 
opment team the extra resour- 
ces it needs to get the (now in 
Beta) Clipper 5.X release out the 
door fast, also, more importan- 
tly, the elusive Aspen Windows 
product. (By the way, what are 
you going to do about dBFast 
when Aspen comes out?) You 
can also afford to market Clipper properly. But how are you going 
to deal, your Hugeness, with those little people upon whom 
Clipper depends for its success? How can you, a massive corporate, 
retain the lightness of touch, the speed of response, the personal 
technical support, the brotherhood of Clipperites? Much as I would 
like to believe otherwise (and I’m not out to get at you - I know I 
had a little dig at your CV back there, but I really do wish you well) 
I can only think of snowballs and Hell. 

I have a bold suggestion. Why don’t you do a swap with 
Microsoft, Nantucket for Fox? You'll end up with a strong product 
which is corporate-punter oriented, exactly you natural habitat. As 
a bonus, it won't be based on a rival’s C compiler. As for Bill, he 
will be saved the hassle of porting Fox from Watcom C; he'll get a 
really excellent piece of software founded on his own C technol- 
ogy, and, what’s more, he has forgotten more about MS-DOS 
development tools than we will ever know, CA. The diversity of 
xBASE would be preserved and everybody would be happy. 

What was that? Oh well, it was only a thought. 
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LOW PRICES 


FOR 
MICROSOFT & BORLAND at 
Be PRODUCTS 


| Microsoft Basic PDS 7.4 
‘Microsoft C/C++ 7.0 
Microsoft C/C++ Upgrade 
Microsoft Cobol 4.5 
Microsoft Fortran 5.1 
Microsoft Macro Assembler 6.0 
} Microsoft Pascal 4.0 a 
| Microsoft QuickBASIC 4.5 
| Microsoft Quick 2.5 
| Microsoft QuickC & Assembler 
Microsoft QuickC for Windows 
Microsoft QuickPascal 1.0 
i Microsoft Source Profiler 
| Microsoft Test for Windows 
Microsoft Visual Basic 
Microsoft VB Prof Toolkit 
Microsoft Windows 3.1 
MS Windows SDK 3.4 
Borland C++ 3.0 
Borland C++ & AFX 3.0 
Borland C++ & AFX Upgrade 
Borland Corporate Prod Pack 
dBase IV 1.5 
ProtoGen for Borland C++ 
Turbo C++ 3.0 
Turbo C++ & Turbo Vision 3.0 
Turbo C++ for Windows 
Turbo Debugger & Tools 
Turbo Pascal 6.0 
Turbo Pascal Professional 6.0 
Turbo Pascal for Windows 
Turbo Vision 3.0 
Paradox 3.5 
Paradox Engine 2.0 


WITH FULL TECHNICAL SUPPORT | | 
C8 Crs Comprters 


NEW HIGH C/C++ 386 3.1 includes templates, 
global optimiser, Borland C++ compatibility options, = 
supports Phar Lap, Ergo & Rational Extenders. 
ONLY £475, | 


] NEW WATCOM C/386 9.0 includes 486 

| optimisations, generates PenPoint and OS/2 2.0 
| apps/DLLs (as well as DOS-386, Windows and 

| AutoCAD ADS & ADI). Can be hosted on OS/2 2.0 i} 
| and integrated with Workframe/2. ONLY £485, 1 i 

NEW WATCOM C 9.0 DELTA PACK adds 16-bit | 
support (DOS, Windows, OS/2 1.x) to C/386 im 

9.0 for ONLY £99, { 

NEW MICROSOFT C/C++ 7 includes the full 
Windows 3.1 SDK (total over 10,000 pages of k 

documentation!!). THIS IS NOW SHIPPING. The 

| Upgrade includes the 3.1 SDK software only - the 

i; additional docs are available separately - 


| call us for details 

| Aztec C86-c DOS £260 i 

) Borland C++ 3.0 Win&DOS = £199 

|) Borland C++ & AFX 3.0 WingdDos 295 |) | 

| Borland C++ & AFX U/G Win&DOS £189 | | 

| Microsoft C/C++ 7.0 Win&DOS £222 | | 

{| Microsoft C/C++ Upgrade Win&DOS = £99 I 

) MS QuickC 2.5 DOS £50 f § 
MS QuickC & QuickAsm DOS £83 |} 

|) MS QuickC for Windows Win £95 ff 

|) Topspeed C Prof Win&DOS £165 
Topspeed C++ Prof Win&DOS £165 | 

| TurboC++ 3.0 DOS = £50 | 

|) Turbo C++ for Windows Win £85 | 

i Watcom C 8.5 OS2&Win&DOS £275 | | 

|| Watcom C 9 Delta Pack for C/386 a 

{} Zortech C++ Win&DOS £370 | | 

| Zortech C++ S8E Win&DOS £550 | 

| High C/C++ 386 3.1 PL386 £475 

|) Intel 386 C Code Builder Win&386 £370 |) 

|) NOP386.C 386 £545 | 

} Watcom C/386 9.0 Win&386 £485 4 

p : — | 

ORTRAN COMPILERS 


NEW LAHEY F77L-EM/32 5.0 is now bundled with 
| royalty-free version of Phar Lap’s Extender & VMM, 
486 optimisation, arrays > 16 Mb, new debugger, etc. 


j ONLY £660. | 

i FS-Fortran 77 DOS £35 

) Lahey F77L 5.0 DOS £340 

| Lahey Personal Fortran DOS £75 | 

| LP! RM/FORTRAN 3.1 DOS £535 ff f 

MS Fortran 5.1 OS2&Win&DOS £205 

| Prospero Fortran DOS £145 
Prospero PC Fortran DOS £55 | 

| Watcom F77 8.5 OS2&Win&DOS £275 

} FIN77/386 386 = «£765 

)  FIN77/486 386 = £895 

i] Lahey F77L-EM/32 5.0 & PL386 386 «£660 | 

| Watcom F77/386 8.5 Win&386 £450 j 

| ij 


We also stock a range of Fortran Libraries. 


GREY 


MATTER 


Prices do not include VAT or other local taxes, but 
do include delivery in the UK and Europe. 

Please cheok prices at time of orderas ads are 
prepared some weeks before publication. 

This page lists some of our products—call us fora 
complete price list and details of discount structure. 
ORDER BY PHONE WITH YOUR CREDIT CARD. 


TEL: (0364) 53499 


FAX: (0364) 53071 


Comms 


C Asynch Manager DOS 
C Comms Toolkit DOS 
Essential Comms DOS 
Greenleaf CommLib 3.2 DOS 
Silvercomm C Asynch DOS 
Database 
Btrieve Win,DOS 
C-tree Plus DOS 
CodeBase 4.5 DOS 
D-ISAM DOS 
Faircom Toolbox Prof DOS 
Pro-C v2.1 DOS 
Pro-C v2.5 00S 
Raima Data Manager Win,DOS 
SoftFocus Btree/ISAM 00s 
Sycero.C Network DOS 
Graphics 
Essential Graphics Chart bOS 
Essential Graphics Kernel 00S 
Essential Graphics GUI DOS 
GraphiC 6.0 bOS 
graphics-MENU & Data Entry DOS 
GSS GDT OS2,D0S 
GX Graphics 2.0 DOS 
HALO Professional 2.0 DOS 
MetaWINDOW 3.7¢ 0OS 
PCX Toolkit 5.0 00S 
Real-Time Graphics & M/CT DOS 
TEGL Windows Toolkit II DOS 
Screen 

C Windows Toolkit o} 

C-Scape + Look&Feel OS2&DOS 
C-Worthy bos 
Greenleaf Datawindows DOS 
MEWEL Window System dos 
Object Professional for C++ DOS 
Panel Plus II OS/2&Win&DOS 


GENERAL PROGRAMMERS UTILITIES _ 


Source Doc/Xref/Pretty Printers 


Flowcharting III DOS 
Easyflow V7 00S 
SourceDoc OS2&D0S 
Source Print 00S 
Tree Diagrammer DOS 
RFFlow 2.0 Win 
Make/Version Control 
MKS RCS DOS 
MKS Make 00S 
PVCS Version Manager DOS 
PVCS Config Builder DOS 
SMS DOS 
Sourcerer's Apprentice Prof DOS 
TLIB 4.12 bOS 


; BASIC FOR WINDOWS 
GFA-BASIC for Windows 


Win 

MS Visual Basic Win 
Realizer Win 

Visual Basic Libraries 

Comms Lib (Microhelp) Win 
PDQ Comm for Windows Win 
Btrieve 5.1 Win 
CodeBase 4.5 Win 
MS VB Lib for SQL Server Win 
ObjectTrieve/VB Win 
| PowerLibw Win 
Raima Data Manager Win 
VB/ISAM MX Win 
Graphics Server for VB Win 
PowerShoW Win 
Microhelp Muscle Win 
MS VB Prof Toolkit Win 
QuickPak Pro for Windows Win 


VBTools Win 
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PROGRAMMING TOOLS 


Ada Algol 
Assemblers AWK 
Basic c 

C++ Cobol 
Comal Comms 
Cross Dev Database 
Debuggers Editors 
Forth Fortran 
Graphics Icon 
Linkers/Locaters Lisp 
Logo Modula-2 
Pascal Prolog 
Rexx Smalitalk 
Snobol4 


Windows Yacc & Lex 


Version Control 


We stock many items for which there is no 


space in these advertisements. 


ProtoGen 


ProtoView Win 
TCXL-DOS 6.0 DOS 
Vermont Views V3.0 bos 
Vitamin C V4.0 bos 


General & Systems Libraries 


C Tools Plus/6.0 DOS 
CodeRunner DOS 
Heap Expander 3.0 DOS 
Hold Everything DOS 
PDK £1, £2, £3 DOS 
PowerSTOR DOS 
Resident-C DOS 
TesSeRact TSR Dev Sys 2.0 DOS 
Math & Scientific 
C/Math Toolchest & Grafix 00s 
Huge Virtual Array & NAT DOS 
Mathpak 87 DOS 
Science & Eng Tools DOS 
Tools 
C-Clearly 00s 
Clear+ for C 00S 
CodeCheck Prof » DOS 
LALR Pro 4.2 DOS 
MKS LEX & YACC DOS 
PC-Lint OS2&D0S 
PCYACC Prof 0OS 
Source Print 00s 


Tree Diagrammer 


TRSDOS, AMSTRAD, ATARIST, MACINTOSH. 


‘We can copy files to and from 600 disk formats including CP/M, CP/M- 
86, MS- DOS, PC-DOS, APPLE, SIRIUS, BBC, TORCH, APRICOT, HP-150, 


Our charge is £10,00 + disk + VAT with discounts on small quantities 
and disks are normally despatched within 24hrs of receipt. 


For more information call us. 


OPTLINK DOS 
OPTLINK/Windows Win 
Phar Lap Linkloc DOS 
Plink86 Plus 00S 
RTLink/Plus 5.0 DOS 


FTL Modula-2 Developer DOS 
Logitech Mod-2 Dev Sys 4.0 DOS 
Stony Brook QuickMod DOS 
Stony Brook Prof OS2&Win&DOS 
Taylor Mod-2 Dev Sys DOS 
Topspeed Mod-2 Prof Win&DOS 


£125 
£290 
£560 
£300 
£290 


Mopura-2 compiters Wy 


£85 
£340 
£95 
£265 
£505 
£165 


Library source is available with some compilers. 
Please enquire about other libraries and utilities 


available. 


ma Pon 


| C++ WINDOWS LIBRARIES 

| Btrieve Win = £310 
CodeBase 4.5 Win&DOS £195 
dAnalyst Gold Win&DOS £230 
POET Win £270 
C++/Views Win £270 
GUI_Master Win £380 
ObjectGraphics for C++ Win £159 
ProtoGen Win £55 
ProtoGen for Borland C++ Win £39 
ProtoView Win = £299 
Win++ Win £145 
Windows Control Palette Win £85 
WindowsMaker Pro Win £575 
zApp Win £125 
zApp wiSource Win £175 
zApp wiSource Win& DOS £280 
Zinc (inc Source) Win&DOS £199 
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v—v—___ News 


SQL for AcuCobol 


Acu4GL is anew tool from AcuCobol Inc 
which provides a way to add a RDBMS 
to an existing Cobol application without 
resorting to hard-coding SQL into the 
application. The first release supports the 
Informix-Online and Informix-SE data- 
base engines, and AcuCobol plans to 
offer the product for other RDBMSs in the 
future, including Ingres and Oracle. 
Acu4GL works in conjunction with the 
company’s AcuCobol-85 compiler. A 
typical development edition of Acu4GL 
forthe Sun SPARCstation, including the 
AcuCobol compiler, costs between 
£3000-£9000 (unlimited users) depend- 
ing on workstation configuration. 


5 From Borland 

Five new Borland language products hit 
the streets this month. These include 
Turbo Pascal V1.5 (TP) (see .EXE News 
May '92) and a Windows-hosted version 
of Borland C++/Application Framework 
(BC++), These products feature support 
for Windows 3.1 and colour syntax 
highlighting. TP V1.5 costs £119.95, 
BC++ V3.1 costs £299.95 and BC++ 
V3.1 with Application Framework costs 
£439.95. Existing users can upgrade 
from BC++ V3.0 to V3.1 for £39.95. 
Phone Borland on 0753 527262 for de- 
tails. 


Windows LanMan 

LanAdmin is a new Windows-hosted MS 
Lan Manager network administration 
tool. LanAdmin provides a protection 
mechanism which limits a network user 
to working only within a restricted Win- 
dows desktop. The user is prevented from 
altering INI files or Windows settings. 
The product also takes care of much of 
the work needed to add new users, prin- 
ters or network applications to the sys- 
tem. LAN Admin costs £400 for a server 
and 10 user configuration, For more 
information contact ABC Systems on 
0970 625515. 


Netware SQLBase 

Novell and Gupta Technologies have an- 
nounced an agreement in which Novell 
resellers will distribute Gupta’s DOS- 
based products for Novell networks. 
These include the SQLBase Server and 
SQL Windows, an application develop- 
ment environment for Windows. 
SQLBase is distributed as a Netware 
Loadable Module (NLM) and costs £995 
fora five user license. The SQLWindows 
product, which includes a five user 
SQLBase licence, costs £2,795. Gupta 
can be contacted on 0628 478333. 


Novell is on 0344 860400. 
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company’s PC-based relational 
substantial increase in speed 


FoxPro V2.0. 


of extended memory under 


(BLOb) data. Extensions to 


boxes interactively. 


Prominaire for OS/2 2.0 


Prominaire is a multi-componented de- 
velopment system for producing C-based 
OS/2 PM programs. There are three (PM- 
hosted) components. The best of these is 
the Prominaire Designer, which is like a 
combination of Borland’s Resource Work- 
shop tool ported to PM together with a 
Case/Windows-like code template generator. 

This code generator is more flexible than 
any other that I have seen. As expected, 
Prominaire Designer can generate a tem- 
plate PM program, complete with giant 
switch statements for you to fill in with 
appropriate message-handling code. Again 
as expected, the program can suck the 
source code back in, even after you have 
made alterations and additions. But here’s 
the clever bit. The program actually parses 
the stuff that it reads in. You are not re- 
stricted to editing only between special 
comments, You can delete the case fora 
certain message, and the program works 
out what you’ve done, and asks politely if 
you want to put it back. You can also cus- 
tomise the code fragments used to build the 
template - indeed, you can customise pretty 
well everything you might wish to alter in 
Prominaire Designer. 

The other two components are Promi- 
naire Editor, a reasonable but unremark- 
able programmer's editor, and Prominaire 
Builder, which integrates the other two 
components, and lets you build projects, 
debug, create make files etc. The system 
knows about a wide range of code and 
resource compilers, make systems, de- 
buggers and so on. 

What with Prominaire, Borland’s C++ of- 
fering in the pipeline, and indeed IBM's 
own C Set/2 and WorkFrame/2, it is inter- 


The new product supports DPMI memory management, so it can take advantage 
rotected Mode Windows, and boasts a new Turbo 
Vision-based user interface. A number of new data types have been added to the 
database engine including Memo fields, capable of holding up to 256 MB of data. 
Borland has indicated that Memo fields could be used to store Binary Large Object 
PAL, the Paradox Application Language, enable the 
developer to write custom applications which incorporate mouse control, pop- 
up/pull-down menus and dialog boxes together with Windows-like controls such as 
push buttons and check boxes. An application generator called Application Work- 
shop has also been added to Paradox; this lets developers ‘draw’ menus and dialog 


Paradox V4.0 costs £499.95, registered 
upgrade for £129.95. Phone Borland on 0753 527262 for details. 


Fastest dBASE 


One of the highlights of the Borland Database Conference in Palm Desert, California 
last month was Borland’s announcement of Paradox V4.0, the latest release of the 
database. Borland says that the new version offers a 
and, in a recent Multi-user Database Program test 
conducted by the National Software Testing Laboratories in the USA, Paradox V4.0 
produced performance ratings which suggested that it was faster than (Microsoft's) 


users of Paradox (V2.0 and above) can 


esting to see that OS/2 is finally getting 
some serious PM development tools. The 
main snag about Prominaire is its price, 
£1400, so I guess They still don’t intend the 
hoi polloi to write applications for OS/2. 
Phone QA Training on 0285 655888 for the 
gen. 


If it moves, buy it 


Symantec Corp has continued the ac- 
quisition fever of the last few months by 
purchasing The Whitewater Group, manu- 
facturer of various Windows tools includ- 
ing the Actor language, and MultiScope Inc, 
creator of a range of debuggers for Win- 
dows, DOS and OS/2. Symantec is not split- 
ting up the development teams: personnel 
of both companies will remain in their cur- 
rent locations. 

The acquisition of Whitewater is made 
more interesting by the company’s pre- 
vious close association with Borland. Bor- 
land used to ship the Whitewater Resource 
Toolkit with its own Turbo Pascal for Win- 
dows, it co-developed the Object Windows 
Library with Whitewater, and Whitewater 
offers an Object Graphics Library which is 
an extension to OWL, Since Symantec of- 
fers a rival C++ compiler (Zortech), it’s dif- 
ficult to see how the Borland/Whitewater 
relationship can continue its current form. 

Symantec's handling of the Zortech pro- 
duct, at least in Europe, has not been very 
dynamic, to put it kindly - for example, techn- 
calsupport has only been available by ringing 
Holland. A new release of Zortech C++ is 
planned in the near future; it is to be hoped 
that Symantec will combine the high quality 
technology of MultiScope and Whitewater 
with Walter Bright’s compiler and re-emerge 
as a notable player in the C++ arena. 


Maximise Productivity, 
Minimise Mistakes 


To produce and maintain reliable software requires a comprehensive configuration 
management strategy. This strategy must support work group development on LANs, 
with distribution across multiple servers, wide area networks, and host systems. 


The PVCS Series for Configuration Management 


— «(Pa 


PVCS Production Gateway 
Bi-directional mainframe 
link that synchronizes 

LAN development — 
efforts with host systems 


The PVCS Series for Distributed Environments 


Personal Workgroup Enterprise Enterprise 
Workstation LAN LAN Workstation 


to 
Main-frame 


Today’s development environment 
requires integrated development effort 
across platforms and operating systems. 


Support for UNIX and heterogeneous workstation and LAN environments. 
To optimise the use of resources, it is imperative for the configuration management system to 
distribute the required functionality to appropriate platforms. This means the manager must operate 
seamlessly across PC-DOS, OS/2, LANs and a variety of UNIX systems. This protects your 
organisation’s investment in existing technology and assures compatibility for future growth. 
Special prices for single users: 

DOS or OS/2 or AIX : PVCS £299 —_ Configuration Builder £135 | PVCS Professional Editor £159 
DOS and OS/2 : PVCS £399 Configuration Builder £175 PVCS Professional Editor £199 


Tel (+44) 071 6255255 FReeadmar Systems _ Sales and Support for 
Fax (+44) 071 624 9404 ; : Development Software 
Prive T EoD 


239, KILBURN PARK ROAD, LONDON NW6 5LG 
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News 


is also complete online documentation. 


with. Thes 


works has also been improved. 


has been certified to comply with the IEE 


New SCO Desktop 


Santa Cruz Operation (SCO) has upgraded its 386/486-based Open Desktop for SCO 
UNIX. Open Desktop Release 2.0 is based on X Windows System Version IT Release 
4.0 and provides 3D animated icons for communicating with local and remote appli- 
cations. Personal productivity applications include a mail and a paint program. There 


Release 2.0 adds to the number of systems that Open Look can operate in conjunction 
range from mainframes and minis, down to OS/2 PCs and and PC LANS, 
as well as other UNIX systems. There is now greater support for DOS, including 
MS-DOS 5.0 and the ability to run MS Windows 3.0 in full-screen mode, In addition, it 
enables the user to access multiple DOS partitions. By providing better TCP/IP and 
NFS services, transparent access to files and resources on distributed computer net- 


SCO says that Release 2 is highly scalable and supports hard disks larger than 1.2 
GB, up to 512 MB of memory and an unlimited number of SCSI devices. The product 
3 POSIX 1003.1 standard and the Intel Binary 
Compatibility Specification (iBCS-2) which enables binary applications to be ported to 
other open systems platforms. Open Desktop release 2.0 is distributed on CD-ROM, 
cartridge tape or on 5.25"/3,5" diskettes. Prices start at £960 for the Personal System 
(for desktop workstations). Upgrading from a previous version of the Personal System 
costs £225. For more information contact SCO on 0923 816344, 


See C 


‘he latest offering from Gimpel Software 
is C-Vision V3.0 which combines the source 
code analysis of PC-Lint (see .EXE May '92 
‘New Improved Lint’) with the reporting fa- 
cility provided by SoftRex’s C:Lines/C:Tree 
package. C-Vision consists of four parts. 
The Source Code Lister enables a developer 
to view the overall structure of the source 
code by illustrating program logic and 
looping constructs. Output from the Lister 
can be configured to display only user-spe- 
cified functions, The Cross Referencing tool 
outlines symbol usage in the source file. It 
provides information which tells the pro- 
grammer that a symbol has been de- 
clared/defined, assigned a new value or has 
had a pointer assigned to its address. The 
Tree Diagrammer is a tool for illustrating 
the flow of a program. It uses a tree-like 
hierarchy to provide formal flow analysis, 
allowing a developer to view the route a 
program takes in order to reach a specified 
unction or the route it takes after this func- 
tion. The final tool in the package is a Source 
Code Reformatter which supports several 
styles of inclentation and commenting. 

C-Vision is ANSI-compliant, supports 
Postscript printers and contains a built-in 
screen previewer. It is available for DOS 
and OS/2. Both versions of the software are 
priced at $139 from Gimpel Software in the 
US on 0101 215 5844261. 


Fractal Lib 


The technique of Fractal Compression, 
previously limited to the domain of special- 
ist hardware with high price tags (it says 
here), is now available as a readily ac- 
cessible software product. Using the same 


Fractal Image format (FIF) as its Fracta 


Transform compression board, Iterated 
Systems has developed Images Incorpor- 
ated, a fractal compression library which 
the company says can produce similar com- 
pression ratios and picture quality as the 
compression board. The package also in- 
cludes Fractal Transform Resolution En- 
hancement which uses a lossless technique 
to improve picture quality of an uncom- 
pressed image. It works by continually ad- 
ding extra detail to the image in order to 
expand the pixel resolution and thus elimi- 
nate the ‘blocky pixelation’ associated with 
low resolution images. Image Incorporated 
costs £450 and is distributed in the UK by 
mago Micro Ltd on 0635 861122, 


xBASE Offer 


Until the end of July, Expert Edge is of- 
fering its Experience for Windows database 
application development tool to xBASE de- 
viopers for £199, In order to qualify for the 
discount, it is only necessary to prove that 
you own a legal copy of any DOS-based 
database, Experience for Windows is an 
event-driven, xBASE compatible develop- 
ment environment. Expert Edge claims 
that, unlike Borland, CA or Microsoft, its 
xBASE language ‘is designed from scratch 
for Windows, is fully object-oriented and 
event driven, and is available now!’ Experi- 
ence consists of a Database manager, a 4GL 
programming language and a Procedural 
Engine which drives the application. User 
interfaces can also be created interactively 
using a Dialog Editor. The latest release 
(V1.1) offers support for various Windows 
3.1 features including True Type fonts and 
standard dialogs. For more information 
phone Expert Edge on 081 9417433. 


Hyper Browser 
Luke is a utility to perform a global 
‘search and replace’ on all source files in 
a directory. Unltke programs such as 
grep, Luke is interactive and gener- 
ates hypertext-style links to the search 
files which lets a user ‘zoom’ into any 
file which matches the search pattern. 
Files can also be ‘tagged’ for selective 
searching. Luke costs £199 from 
Polyhedron Software on 0865 300579. 


Running Mail 


-Finasa Lid has developed a technology 


Jor displaying Windows documents. The 
Self-Displaying Document Standard 
(SDD) aims to resolve one of the prob- 
lems facing Email - ie how a recipient of 
mail can read a file format which his 
system doesn't support. Finasa’s answer 
isto provide an executable which encap- 
sulates the file, When this is run, data 
can be viewed, printed or copied to the 
clipboard. Details of the standard can be 
obtained from Finasa Ltd on 071 
4054045, 


LPA supports 3.1 

Logic Programming Associates (LPA) 
has upgraded its range of Windows de- 
velopment tools for Prolog. Version 1.2 
offers support for Windows 3.1 and in- 
cludes an integrated source-level de- 
bugger and a dBASE III interface. 
Introductory prices are: £395 for LPA 
386-Prolog, £645 for Prolog++/386 and 
£895 for flex/386, before the end of July. 
Phone LPA on 081 8712016 for details. 


PCUG Connects 

The long standing Connect service of- 
[ered by the IBM PC User Group (IBMP- 
CUG) has been licensed to provide the 
Pipex internet services. Pipex was 
launched in January and offers the 
facility to send and receive UUCP 
EMail from Internet, file transfer and 
remote logins and a Conference ser- 
vice called Internet Relay Chat (IRC). 
Pipex is open to both n 2mbers and 
non-members of the IBMPCUG. An- 
nual members subscription is £130. 
Call IBMPCUG on 081 8631191. 


SQL Upgrade 

SQL Server V4.2, Microsoft's latest of- 
fering, comes complete with OS/2 V1.3 
and features Remote stored proce- 
dures, improved fault tolerance and 
greater connectivity to RDBMSs such 
as Oracle, DB2 and Ingres. A 10 user 
license of SQL Server costs £2,295. A 
Programmer's toolkit is also available 
in C, Cobol and Visual Basic, each 
costing £335. Microsoft is on 0734 
270001. 


EXE Magazine, Vol 7, Issue 2, July 1992 


9 


10 


er 2/ 


dBASE IV to Clipper 

Matt Whelan’s Compiler Kit - dBASE IV 
Edition is a preprocessor file for Clipper 
5.0L which allows you to compile and 
execute programs written in the dBASE 
IV dialect of xBASE. The supplier is Ing- 
ram Micro (0908 260422), the RRP is 
£250, or £650 bundled with a copy of 
Clipper. 


Paperweight 

LaptopTV, from Willow Peripherals, is a 
new VGA-to-video convertor (to both Eu- 
ropean PAL and NISC) which plugs into 
the VGA port of any PC or laptop and 
produces 24-bit colour output at 640 by 
480 resolution. Willow says that the 2.5 Ibs 
device incorporates the company’s Clear- 
View anti-flicker technology to produce 
high quality presentations. Willow is work- 
ing on an adapter which will enable Lap- 
topTV to operate with the Macintosh, 
LaptopTV costs $1,195 from Willow Pe- 
ripherals on 0101 212 4029500. 


Virus Legality 

Virus Bulletin reports that Mark Ludwig, 
the American author of The Little Black 
Book of Computer Viruses, is pleading the 
First Amendment to defend the book's pub- 
lication. The Little Black Book is an in- 
struction manual on how to write 
computer viruses, complete with example 
code. Virus Bulletin is on 0235 555139. 


Spoilt for Choice 

IBM intends to pre-install OS/2 V2.0 on 
its entire PS/2 family and has started by 
providing Model 56 and 57 PS/2 ma- 
chines with OS/2 V2.0 ‘ready to run’. In 
retaliation, Microsoft has said that it will 
be offering a combined Windows 3.1 
and MS-DOS 5.0 package for PS/2s. 
Although the package is aimed at re- 
sellers, it is available ‘of the shelf’ for 
£149. IBM can reached on O81 
7470747. Microsoft’s rude computer is 
on 0734 270001. 


Robo Olympics 

‘The Institute of Electrical Engineers (IEE) 
is hosting this year’s MicroMouse competi- 
tion to find the world’s fastest small robot. 
The race will be held on 7th July and 
involves finding the fastest route to the 
centre of a maze in the shortest possible 
time. Contact Debbie Callard at the IEE on 
071 2401871 for details. 


Errrmm... 

Here are the results of the .EXE-spon- 
sored Richmond Womens’ Rugby Club 
tour of the USA. Played 5, Won 0, Drew 
0, Lost 5. Ahem. Anyway, we always said 
it was as silly game. And now, a look at 
the weather, 


CA buys Realiser 


After last month’s major upheaval of 
the Clipper community (see .EXE June 92 
News ‘Clipper Buyout’), Computer Associ- 
ates (CA) has extended its grip on the PC 
development tools market this month 
with its recent acquisition of Realiser 
from Within Technologies. ‘...CA has 
standardised on Basic as the macro lan- 
guage for all our Windows products,’ said 
George Karkarkou, the general manager, 
‘with Realiser we are extending this con- 
cept’. Itseems that CA intends to promote 
Realiser as an application development 
language for the end-user, Realiser is con- 
sidered by many to be a primary compe- 
titor to Microsoft’s Visual Basic in the 
lucrative market of interactive programm- 
ing tools for Windows. CA can be reached 
on 0895 272501. 


First Oberon-2 


Real Time Associates (RTA) has re- 
leased a new product which the company 
says is the first commercial implementa- 
tion of Oberon-2, the latest language 
from Niklaus Wirth, inventor of Pascal 
and Modula-2. The new product is called 
Extacy and contains both an Oberon-2 
compiler and a Modula-2 compiler. Both 
compilers produce ANSI C as output. Ex- 
tacy is available for a number of platforms 
including MS-DOS, UNIX and VAX/VMS. 
In the DOS-version, code generated by 
the compilers is then processed by Cla- 
rion’s Topspeed C, also included in the 
package, in order to create an executable. 
Extacy comes complete with standard 
and extended Modula-2 and Oberon-2 
ibraries. The MS-DOS version costs £250 
from RTA on 081 6567333. 


News 


32-bit Comms 


Magna Carta Software is now offering a 
version of its C Communications Toolkit for 
the Phar Lap 3861DOS Extender. The C 
Communications Toolkit is a comms library 
which provides interrupt-driven serial I/O, 
supporting transmission rates up to 115,200 
bps. The library works with any Hayes- 
comipatible modem and provides the pro- 
grammer with the XModem, YModem, 
ZModem and Kermit file transfer protocols. 
C Communication Toolkit also includes sup- 
port for CAS-compatible fax cards and pro- 
vides emulations for VT100, VT52 and ANSI 
terminals. C Communications Toolkit/Ex- 
tended DOS costs $299.95 directly from 
Magna Carta Software on 0101 214 2266909. 


.C++ GUI Designer 


ViewCenter is a new interactive GUI design 
tool from CenterLine Software (previously 
Saber Software) which supports Open Look 
and Motif. Both the user-interface of the ap- 
plication being designed and that of the tool 
itself can be selected at run-time. This enables 
developers and end-users to choose whether 
they wish to work under Open Look or Motif. 
ViewCenter includes a documented copy of 
the Object Interface class library which allows 
developers to customise their user-interfaces, 
Once the GUI has been created, ViewCenter 
produces application templates and ma- 
kefiles which build a ‘runable’ template. It 
integrates within ObjectCenter, Center- 
line’s integrated development environment 
which includes a source-level debugger 
and a C++ run-time error detection system 
that the company says is unique. View- 
Center costs £2300 for Sun workstations 
and is distributed in the UK by K2 Software 
on 061 7764541. 


for accessing the data. 


Microsoft on 0734 270001. 


Windows DB Spec 


Open Database Conectivity (ODBC) is Microsoft's answer to the question of how 
to make applications database independent. The technique, which will initially be 
available for Windows 3.x, is based on the Call Level Interface (CLD specification as 
proposed by the SQL Access Group. This is a database-independent API for both 
non-SQL and SQL databases. ODBC consists of two parts. The ‘front-end’ is the CLI, 
a database-independent API which passes SQL-style requests to the ‘back-end’ 
Service Provider Interface. This translates the request and sends it to the underlying 
database engine. In the case of a SQL database engine this would take the form of a 
‘one-to-one’ translation to the relevant SQL dialect. However ODBC can support any 
database, as well as a plain ASCII text file. In this case ODBC provides its own engine 


Microsoft is committed to providing ODBC connectivity to database engines from 
several manufacturers including DEC, Oracle and Borland. A number of companies 
have indicated that they will support ODBC. These include Oracle, Novell, Sybase 
and Ingres. A beta release of the ODBC SDK is available now on the public domain. 
This isa complete product which includes its own database engine (ie you don’t need 
SQL Server). Microsoft is planning to release the final product later this year and will 
also be holding ODBC developers’ conferences. Further details can be obtained from 
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Mier has launched a program- 
ming system to allow users of 
its Windows graphical interface to 
clop and tailor business applica- 
tions. 

The company claims Visual Basic 
allows users to dev 
Windows 3.0-based utilities or appli- 
cations to link into progrants such as 
Excel or Superbase 4.0. 
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oft's chief executive officer, 
s. “My goal from the start was 
to make developing applications as 
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in the future? Yes No 
R.R.P.(or£99 forthe upgrade)*C/C++7.0 EU ee eH Le ey ee ULE 


*Upgrade offer expires 30th June, 1992. The upgrade excludes certain SDK manuals which are available for an extra £99. 
386 MAX is a registered trademark of Qualitas, Inc. 
Microsoft and the Microsoft logo are registered trademarks and Windows is a trademark of the Microsoft Corporation. 
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Meet the growing family of security keys 
from Software Security. 


Each one a specialist at enforcing your 
license agreement in virtually any user 


environment you can think of. Whether it's 


DOS, UNIX, Macintosh or OS/2... whether 
it's a single user installation or a LAN. 


THE ULTIMATE 
PROTECTION 
FOR SOFTWARE 
PUBLISHERS 


All product names are trademarks or registered trademarks of their respective holders. 


Simply connect the appropriate key to a 
single user computer, or a non-dedicated 
file server in a network, and you control all 
access to your protected application. 


Users, however, won't even know it's there. 
Ihe keys are transparent and won't 
impact software functionality or the ability 
to make back up copies. Normal node 
and LAN operations are unaffected. 
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Simple. Unassuming. Ever vigilant. Easy to 
incorporate into your application 
package. And quite possibly the most 
profitable hardware Investment a 
software developer can make. 


To find out more, call: 


(0784) 430060 | 


Software Security International Ltd 


21a The Precinct, High Street, Egham, Surrey, United Kingdom, TW20 9HN 
National telephone: Egham (0784) 430060 fax: (0784) 430050 International telephone: +44 784 430060 fox: +44 784 430050 
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Letters 


We welcome short letters on any subject that is relevant to software development. Please write to 
The Editor, EXE Magazine, 10 Barley Mow Passage, Chiswick, London W4 4PH. Unless your leiter is 
marked ‘Not for Publication’, it will be considered for inclusion in this section. 


The next step for OO 


Sir, 

The recent articles in .EXE debating the 
merits of C++ and the object-oriented meth- 
odology in general have been instructive. 
To date, however, I have not seen any 
mention of some limitations of C++ that 
concern me. First, the implicit assumption 
that all objects share the same address 
space and that member functions can be 
executed by jumping to an absolute ad- 
dress, albeit via a lookup table for virtual 
functions. Second, only one member func- 
tion from the set of objects can be currently 
‘active’ due to the single thread of control 
in a DOS program or UNIX process. 

If one applies OOA/OOD ideas to a real- 
istically complex problem domain, then it 
becomes apparent that the most powerful 
model is a set of persistent, communicating 
objects. Such a model implies that the ob- 
jects can respond to asynchronous events 
and that some may act as ‘servers’ or agents, 
acting on a queue of messages received to 
invoke member functions. Clearly, one 
could imagine spreading these objects over 
several processors, with the usual options 
of shared memory or network connections. 

Such an architecture raises complex 
questions about how member functions 
should be invoked, and how the private 
state of objects can be kept consistent while 
handling concurrent execution of member 
functions from multiple control threads. 

Until we have seen the implementation 
of the research on distributed object man- 
agement and OO programs with multiple 
control threads, then the full promise of 
object-orientation will not be realised. 

Mr Calum Steen 
Bretton, Peterborough 


A Pragmatist writes 


Sir, 

Further to Mr Papzissimou’s letter in the 
February issue, and Charles Treen’s and 
Mike York’s letters in the April issue, I 


would like to draw attention to something 
essential that seems to be missing. 

There can be no question that there is an 
enormous pool of mature and not so ma- 
ture talents in programming, lying idle on 
our island. This is tragic, but one of the 
principal reasons that this is the case has to 
be organisational - a reflection probably of 
outmoded structures and inappropriate 
business traditions. 

The suggestion of starting a software 
coéperative is excellent, but it seems to me 
that cart is being put before horse. Before 
programmers are recruited, surely market re- 
search needs to be done to discover what 
software the market wants and in what form? 
Then the software needs to be designed and 
the whole project managed and coérdinated, 

What first must be evaluated is whether 
there is an adequate pool of idle market 
research experts with access to appropriate 
tools and unemployed project managers 
with the right experience. The market re- 
search stage could involve considerable in- 
vestment which would have to be covered 
up front. This implies that the codperative 
needs a certain amount of capital, which in 
turn means examining the legal implica- 
tions of the venture. 

I suspect it could transpire that inadequ- 
ate attention to these matters has a lot to do 
with creating the pool of idle programmers 
in the first place. 

Euan Hill 
Carshalton, Surrey 


Unknown bugs 


Sir, 

I was very interested in Andy Pennell’s 
letter about bugs in Microsoft C/C++ V7.0. We 
are still waiting for a response to 10 bugs we 
reported in MASM V6.0 over a year ago. 

As someone who spent days fixing bugs 
in both Microsoft C V5.1 and V6.0, I recom- 
mend not using Microsoft compilers for 
production work in the first year of their 
release. Indeed, Microsoft isn’t on our 
short-list for compilers. 


This position might be reconsidered if 
Microsoft were to publish a bug-list. One of 
the most welcome surprises of IBM’s new 
C Set/2 compiler was its list of known bugs. 

Stephen Westlake 
Windowmaker Software 


... and some balance 


Sir, 

It was interesting to read Tim Meadow- 

croft’s complaints about bugs in his C++ com- 
piler and Borland’s response when asked to 
correct them (.EXE Letters, March '92). 
Our copy of Borland C++ 2.0 had lain un- 
wrapped, awaiting the momentwhen we were 
prepared to see another 15 MB of disc space 
disappear, What prompted its installation was 
not an insatiable appetite for OOP, but the 
surprising discovery that Paradox Engine ap- 
plications hang if they were linked under the 
Turbo CIDE, a surprising incompatibility, con- 
firmed by Borland but documented only by 
omission in the Paradox Engine manual. 

We were a little disappointed that quite a 
modest application which had taken a few 
seconds to link under Turbo C now took 
rather longer (we gave up and reset the ma- 
chine after it had thrashed the disc for an hour 
anda half). Still, ‘That’s progress’, we thought, 
and plugged in an extra few meg of RAM. 

Away we went, playing with all the fa- 
cilities in sight. True, the IDE did sometimes 
crash out when doing unambitious things 
(like moving the cursor), but we don’t ex- 
pect any software to be perfect and could 
live with the odd bug or two, a few of which 
we thought it relevant to report. 

Like Tim Meadowcroft, we found Bor- 
land’s response to bug reports to be at the 
very least irksome. When we reported a 
bug concerning short (1-byte) enumerated 
types (they don’t work properly), we were 
told that this was fixed in version 3.0 of the 
product. Surely even the worst of car sales- 
men wouldn’t be found saying ‘Well, to tell 
you the truth, squire, they never did get the 
electric windows working on your model, 
but you can still use the winder and if you 
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fork out half as much again, I'll do you a 
good part-ex on the GTI.’ 

Even a single mention of that old-fa- 
shioned lubricant ‘sorry’ would be wel- 
come. No doubt the the liability this implies 
would send Borland lawyers into quivering 
spasms. Instead, the company’s standard 
closing sentence is ‘Thank you for your 
interest in Borland products’, Interest they 
say. It hardly seems an adequate word for 
our concern about software for which we 
have paid several hundred pounds and on 
which our livelihood depends. 


Barry Lord 
Dataflex Systems Ltd 
Rochdale 


Justice for C-Heap 


Thank you very much for your review of 
memory managers in the April issue of 
.EXE, and for including C-Heap in the re- 
view. I think it is important to make a few 
points with respect to the review. 

First, Mr Saran said that there is little advant- 
age in using a memory manager that allows 
allocation of memory from UMBs through 
malloc (),since DOS 5.0 allows allocation 
from UMBs directly. He must not have been 
thinking about it from a programmer's point 
of view! The object is to be able to allocate 


from either UMBs or conventional memory 
by making a single function call, and more 
important, to let the memory be accessed 
through standard memory allocation calls. 
DOS doesn’t allow this on its own. More- 
Heap and C-Heap do (the latter through a 
recent upgrade). 

Second, Mr Saran pointed out that 
XMem’s virtual memory manager can be 
configured as malloc(). So can C- 
Heap’s. However the reader must not be 
misled into believing that the virtual mem- 
ory capabilities of XMem or C-Heap can be 
utilised through malloc (). If one uses 
Mr Saran’s technique, one cannot access 
memory outside of conventional memory, 
which is the whole point of using a virtual 
memory manager in the first place. 

Third, Mr Saran ran some benchmark 
programs to measure memory fragmenta- 
tion. Compared to other products, C-Heap 
appears to fragment very badly in the graph 
of the results. Mr Saran was good enough 
to send me a copy of the test program, and 
I founda coding error in the test code which 
had a significant effect on C-Heap’s results. 
C-Heap does not behave in a less favour- 
able manner to the other products exam- 
ined with respect to fragmentation. 
was disappointed that, probably due to 
space limitations, the reviewer was unable to 
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describe C-Heap’s virtual memory capabilities. 
I believe that they are equal to those of any 
other product reviewed, and I hope the 
reader will keep this in mind. 
Finally, the price of C-Heap is $199 US, 
not $399 as given. 
Mr] Harrington 
Library Technologies 
Cliff Saran replies: 
‘The point about using a malloc () 
macro with XMem was that, unlike C-Heap, 
XMem did not supply an API compatible 
with the standard C runtime. 
acknowledge the coding error in the frag- 
mentation test, and apologise for the mis- 
take. Mr Harrington is right to say that the 
results of the C-Heap test should be ignored. 
‘The price that we gave was correct at time 
of going to press, although Mr Harrington 
did indicate it was under review. We are 
pleased to print the revised price.’ 


Letter of the Month 


The writer of the best letter of the 
month, as judged by the Editor, will 
receive a £20 book voucher, courtesy 
of Just Computer Books. The best letter 
is the one printed first. Please note 
that letters submitted to this page may 
be edited. 


Buy EZWIN321° or NDP-GKS” from 
Microway and we will give you an 
NDP Cc, C++. Fortran or Pascal 
Compiler absolutely 

FREE OF CHARGE! 

EZWINS®2 provides the first multi- 
language support for the Windows 
3.0 platform. Microway’'s globally 
optimising, protected mode NDP-386 
Compilers ca 
now take advan- 


applications 
which utilise the four gigabyte flat 
memory model of the S86 running in 
Windows 386 enhanced mode. 
EZWINS2 is priced at £395. 
NDP-GKS is a library of com- 
puter graphics functions that are 
portable across a large number 


of computers and = graphics 


EUROPE 
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A 
tage of the 

Windows 3.0 

environment. 

Programmers 

can run 3e-bit 0 


devices. NDP-GKS provides facilities to 
draw and manipulate primitives, perform 
interact with an 
images to other 


raster operations, 
operator, transfer 
computers, plus many other functions. 
It is designed to be used in conjunction 
with Microway’s NDP Fortran and C 
i386, i486 and i860 
is available for both 
DOS and UNIX. 
NDP-GKS is 
priced from 
£776 for the 
DOS version. 

To find out 
more about 
Microway's 386, 
486 and 860 compilers and this offer call 
our Technical Sales Department at:- 

Microway (Europe) Ltd., 32 High St, 


compliers for 
processors and 


MICROWAY kingston upon Thames KT1 1HL 


Tel: 081-541 5466 


for FREEFONE MICROWAY. 


i Fax: 081-546 0614 or 
A 4 dial 100 and ask the operator 


UK Coupon 


Dan Ratigan, 
Hasbro 

Systems Analyst, 
Is now 
CODE-FREE. 

HE SWEARS 

HELL NEVER 

GO BACK, 


MSE - U.K. Tel: (081) 902-8998, Fax: (081) 903-1465 


MSE - U.S, Tel: (714) 250-1718, Fax: (714) 250-7404 
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Oe you've kicked the code habit, 
you'll never go back. Just ask Dan 
Ratigan. He increased his productivity 
70% by switching to Magic - the first 
truly code-free application develop- 
ment tool. Unlike 3GLs and 4GLs, Magic 
lets you develop applications by logically 
describing their functionality in a 
table-driven prototyping environment. 
This unique object-oriented, code-free 
methodology slashes your development 
and maintenance time by up to 90%! 


Say YES to Magi Productivity 


3GL, 4GL; 

Design 
Code/Compile/Link 
Debug 

Re-Code 


Programming Cycle Comparison 


MAGIC 

Fast, Incremental 
Development: 
Design, Prototype, 
Test and Modit 
All-in-one 


Despite this incredible programming 
speed, Magic is no toy, It delivers 
superior programming power - excelling 
in the building of sophisticated database 
~ applications with advanced multi-user, 
multi-line and multi-window 
functionality, Transparent portability and 
interoperability across platforms, plus 
client/server support, make Magic the 
ideal strategic tool for open environment 
computing*. 
To join over 100,000 code-free Magic 


® users, send in the coupon below. 

S * DOS, LANs, UNIX, VAX/VMS, 05/2, and 
CTOS/BTOS are all supported along with MS - 
Windows deployment 

Hasbro is a registered trademark. 


Postini 
Gomibany inet nese eeieee SY 
(e\0 (61: ee ee ney y 
| 
Fax | 
| 


MSE UK Ltd., Fulton House, Fulton Road, 
Empire Way, Wembley Middlesex, HA9 OTF 


PNAGIC 


Magic Software Enterprises 
PRODUCTIVITY BEYOND 4GL 


Ne 


MSE - International H.Q, Tel: (972-3) 751-1914, Fax: (972-3) 751-1901 


Practical SQL 


Serving Up Data 


Andrew Terry goes beyond the basics of SQL servers, 
and reveals some things the salesman may not tell you. 
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SQL databases are rapidly becoming one of 
the most important ways of storing corpor- 
ate data. Increasingly programmers find 
they need to interface their programs to 
SQL, even if they are not primarily database 
applications. It’s not difficult to find refer- 
ence manuals on the SQL language itself, 
but beyond that there are other issues a 
programmer needs to understand that af- 
fect portability and performance, such as 
transaction logs, locking and query opti- 
mising, It is a big complicated subject, but 
this should give you an idea of some of the 
problems involved in adding SQL support 
to your programs. 


Benefits 


Scaleability. The same client programs 
can use different servers running on dif- 
ferent machines. If your 486 server gets 
too slow, replace it with a multi-process- 
ing UNIX box. The client machines and 
programs are unchanged. 


Security.The server has very precise 
control over data access for each user. 


Integrity. Transaction processing en- 
sures database integrity is maintained 
after hardware or even software failures. 


Standard. SQL is fast becoming the stand- 
ard for database systems, despite the fact 
that SQL itself is not standardised. 


Rules. In some servers, data integrity is 
further enhanced by rules held at the 
server. Kor example, you cannot delete a 
customer record when there are still cur- 
rent orders for that customer. This cen- 
tralised integrity is much more robust 
than relying on many different pro- 
grammers and users to enforce it. 


Optimisation. The application can be 
optimised without re-coding it. 


Multi-user. SQL servers are automatically 
multi-user, 


Ease of access. Powerful ad hoc data man- 
ipulation and retrieval can be done without 
a programmer. This is a very attractive fea- 
ture for most end users. 


... and disadvantages 


Resources. SQL servers have much more 
overhead, especially in CPU and memory 
usage, than file handlers, They therefore 
need more expensive hardware. 


Expense. The SQL server program itself is 
usually expensive. 


Complex. SQL servers are highly complex, 
so there is more to go wrong. 


In general the advantages of the client serv- 
er approach outweigh the disadvantages, 
except where price is the major consider- 
ation. For one-off systems the higher level 
data access will usually make the whole 
system cheaper since the overall pro- 
gramming time will be reduced. 


Horses for Courses 


In the past SQL server manufacturers have 
supplied client development tools as well 
as server software. So if you decided to use 
Ingres, for example, as your server, you 
would have used Ingres 4GL for your ap- 
plication development. Now, however, 
true client server often means that client 
and server programs run on different hard- 
ware and operating systems, and we have 
a much wider choice for client develop- 
ment tools. When you think about it, 
clients and servers have completely differ- 
ent characteristics and requirements, so 
this client-server split make perfect sense. 


MS Windows, for example, is well suited to 
client applications. PC hardware and soft- 
ware are cheap and extremely well sup- 
ported. The GUI makes applications much 
more powerful and easy to use. Developers 
can bolt systems together from standard 
components using DLLs, DDE, OLE etc as 
well as writing application specific pro- 


CREATE 


With You Cea More Time Doing What You Do Best. 


zApp is a C++ Application Framework designed to free you from the complex details of 
programming in Windows, OS/2 2.0, DOS and UNIX X/MOTIF. With zApp you can now cut 
development time and code length by up to 80%! Leverage your development. Why program for 
only one environment when you can have them all? zApp gives you single source code 
compatibility so you can run your application on all the 
above platforms, just by recompiling. Have all the objects 
you’ Il ever need. zApp provides you with over 130 ready 
made object classes, encapsulating all the facilities you need 
to quickly create sophisticated applications, from Windows, 
Dialogs, Controls, Menus, Fonts, Graphics, Bitmaps, to 
EE MDI, Printing, Memory Management and Forms. Get up to speed (in hours, not 
q months). zApp comes with comprehensive tutorials and over 35 sample 
programs, many based on examples from Petzold’s "Programming Windows", 
and others which show you how to use facilities like 3-D tool bars and status 
lines. You can use zApp now with your existing Windows programs written in C 
or C++ and get immediate productivity gains. Rise above the chaos and join the 
new order.Try zApp risk free for 60 days. If at any time 
you’re not satisfied, just return it for a full, unconditional 
refund. Call Grey Matter on (0364) 53499 or contact 
us via fax or CompuServe to join the thousands 
worldwide experiencing the benefits of zApp. 


SOME OF ZAPP’S Frame/Pane Flexible Message Advanced 
ADVANCED Architecture Sc; Handling Messagescan — Printin, penne 
FEATURES INCLUDE: indows be dynamically ccna Includes banding, 
toany object atcompile status dialogs, and 
He eittied Micdew time or runtime. printer configuration. 


window in one line of fee iiyarmehed 


i Y Transparent MDI Tis 
code, Le ached to differ- §ypport Instantly convert 
ent frames which greatly single document applica- 
Unified Display increases code reuse and tions to MDI, Menu Pricing 
Architecture (Device simplifies maintenance. switching and other App for: 
Context) Use the same automatic Window complex details are han- Windows £190 C++ 
drawing code for windows, bate ‘ 


dled automatically, 


ers, bitmaps, meta- Windows 

ata OL hy mete Controls Automatically w/Souwce £180 iatadices 
cee aetsts superclassed at runtime, : Framewor' 

Fixed Toxt Pane Printf including third party ROS a nas 


toa window without wor- greatly simplifyingcomplex custom controls. 

rying about repainting. screen design. Automatic Optimized CEN eo ok, 
Logical Size and Data Entry Forms Memory Management 

Dimenstoning Objects Comprehensive input val- System Hundreds of UNIX MOTIF 
Automaticall s_ idation for simplified data thousands of objects can "/Sowee 4th Q"92 
based on display me: entry dialog box creation. be allocated. 


zApp requires no run time royalties, is available with source and is written in standard C++. zApp supports Borland 3.0, 
Microsoft 7.0, Zortech and other C++ compilers, For a free copy of the zApp demonstration software, send us a request 
via CompuServe or call Grey Matter. Corporate training available. 


2065 Landings DriveMountain View, CA 94043 Grey Matter (UK), Prigg Meadow 
ae | Phone 0101 4156919000 Fax 0101 415 691 9099 Ashburton, Devon TQ13 7DF 
4 BBS 0101 415 6919990 CompuServe 705502570 Phone 0364 53499 Fax 0364 53071 
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System Architect not only has the power and flexibility to handle your most complex application, it is easy to 
use and affordable. As the only CASE tool to be specifically developed for MS Windows, System Architect brings 


you a graphics oriented, fully integrated multi-user development platform for PCs. 


In addition to standard CASE tool features, System Architect offers a wealth of additional functionality. 


Methodologies Supported 
¢ SSADM 

© Yourdon/DeMarco 

© Ward & Mellor 

¢ Object Oriented 

© Gane & Sarson 

¢ Information Engineering, 


Full Data Modelling 
Lifecycle Support 


¢ Requirements Tracking 
¢ Analysis/Design 

¢ Prototyping 

© Schema Generation 

© Code Frame Generation 


Benefits 

Ease of Use 

° Readily Affordable 

¢ Networking 

¢ PC Based 

¢ Increased Productivity 


—_= 
Gitte (2! System Architect Help - SYSARCH.HLP (EE 


To arrange a demonstration, 


attend one of our regular System Architect seminars, 
or for further information please phone us on 


Tel: (0926) 450858 
Fax: (0926) 422165 


Supporting IBM’s AD/Cycle 


Real-Techniques and Methods Limited 


118-120 Warwick Street, Royal Leamington Spa, 
Warwickshire, England CV32 4QY. 


Special Features 

¢ User Definable Attributes 

© Customisable Reporting System 
(Matrix and Tabular) 

¢ Automated Documentation 

¢ Import/Export/Extract/Merge 

© Multiple Document Interface 

¢ Import of External Graphics 

¢ CRUD Matrices 

© Mini-Spec Balancing 

© OS/2 Support 


Proven Reliability 


© Over 6,500 licences installed. 
Users include: 
© NCR ¢ Toshiba ¢ Racal 


¢ IBM ¢ Bull ¢ Prudential 


Training and Support 


Full training and support for both the 
novice and advanced user. Also 
training courses in Structured Methods 
and Object Oriented approach. 


Systene Architect 
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grams using any of an amazingly wide 
range of powerful development tools. 


Servers, on the other hand, have complete- 
ly different hardware and operating system 
requirements such as good security, resist- 
ance to hardware failures and high I/O 
throughput. Traditional minicomputers are 
well suited to this, so increasingly we will 
see UNIX and VMS boxes running an SQL 
server supporting a network of client PC’s 
running Windows or similar. This server 
machine probably runs no programs other 
than the SQL server and maybe some print 
services. For smaller networks, Novell Net- 
ware 3 is a good example of an operating 
system that is specially designed to run 
server programs with maximum efficiency. 


Talking to the Server 

There are several ways to interface your 
program with a server, Each server manu- 
facturer has its own favourite. 


a) AC Application Programmer's Interface. 
These are completely non-standard but are 
the most flexible for programmers. Gupta’s 
API supports not only their own servers but 
also Oracle and DB2. But you must buy 
extra Gupta connectivity modules to pro- 
vide this transparency. 


b) Embedded SQL/C. SQL commands are 
embedded directly into C code, and then 
pre-processed into normal C. This is fairly 
well standardised (although the SQL is not). 
Look for an implementation that supports 
Dynamic SQL, otherwise only hard coded 
queries are supported, 


c) Other client programs. For example, a 
Windows client program may well let you 
access the server via DDE. 


Each server manufacturer supports a num- 
ber of different client operating systems, 
networks and interface methods. You 
choice of server may depend on a suitable 
interface being available. Increasingly we 
will see Windows DLLs supplied which 
take care of all networking and communi- 
cations with the server. 


There are now a couple of companies (such 
as TechGnosis) which supply ‘glue’ soft- 
ware for client software to talk to different 
servers, While this is more expensive than 
writing direct to a server API, it can take 
some of the hassle out of porting (althoug! 
not all of it by any means), 
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Flavours of SQL 


Each manufacturer’s version of SQL is dif- 
ferent. Sometimes the differences are ob- 


vious, like using different syntax to achieve 
the same thing. Other differences are more 
subtle, such as features supported by one 
server but not another, or features that work 
differently. Once you get past the most 
basic Select and Update statements 
the differences will multiply. There has 
been some ANSI standardisation of SQL, 
but this covers only portions of the lan- 
guage. 


So is it possible to write applications that 
will run on different servers? The answer is 
a qualified ‘yes’. Great care must be taken, 
and some SQL statements may have to be 
rewritten for each new server. If your server 
supports stored queries, you can put SQL 
text in a separate script file and keep the 
application itself much more server inde- 
pendent. You must also avoid some of 
those special features that other servers do 
not support. The problems will be greatest 
when you are trying to get peak perfor- 
mance out of the system. To do this you will 
need to use more and more server-specific 
features at the expense of portability. 


As an example, consider scrollable cursors. 
Here is a really useful special feature that 
may be ruled out because of portability 
concerns. 


SQL manages data in sets, eg 


Select name from customer 
where postcode like 'BS%’ 


defines the set of customers with a Bristol 
postcode. We do not know what order the 
data will be returned in (unless we rely on 
particular features of the server). Most ser- 
vers retrieve data row by row using a ‘cur- 
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sor’, which is a pointer to the current posi- 
tion in the set of data. The cursor is associ- 
ated with an SQL statement and then data 
is fetched row by row. Unlike file handlers, 
data must be read sequentially through the 
data set. It is not possible to skip about the 
data set or read in reverse order. This is 
inflexible and makes writing scrolling lists 
of data very difficult. What happens when 
the user wants to scroll back towards the 
top? Either the front-end program must im- 
plement its own (possibly virtual) memory 
system, or the size of the data set is limited. 
Alternatively, a new query may be needed 
- which imposes speed penalties. To ad- 
dress this problem, some server manufac- 
turers are starting to implement scrolling 
cursors, but not all of them have done so. 
The only safe way to write really portable 
code is to avoid this feature. 


Transaction Logs 


Transactions are one of the most powerful 
features of SQL servers. Figure 1 is an 
example that uses a transaction. The dura- 
tion of a transaction is between the com- 
mit statements. At any point before the 
commit, the transaction can be aborted 
with a rollback statement. This undoes 
all SQL statements back to the last com- 
mit. This means the programmer can em- 
bark on a whole series of related updates 
without having to worry about undoing a 
partial update should something go wrong. 
What’s more, transactions play an import- 
ant role in crash recovery. Should the server 
crash in mid-transaction, it will unwind the 
partially completed transaction when it 
restarts, So we might lose a little work, but 
at least the database is always consistent. 


// SQL is embedded into C by prefixing it with 
// 'EXEC SQL’. SQLOK is a macro to check for 
// errors in the last SQL statement. Invoice 
// consists of a header record + an item 

// xecord for each item on the invoice 

// SQL insert statement adds a row (record) 

// to a table: 

// BXEC SQL insert (<SQL Column names>) 

// values (<C variable names>); 


EXEC SQL insert into 
invoice_header(invcode, custcode, invdate) 
values (InvCode, CustCode, InvDate) ; 
ok = SQLOK(); 
for (i = 0; ok && i < NumItems; i++) 


EXEC SQL insert into 
invoice_item (invcode, quantity, 
stockcode, price) 
values (InvCode, Quantity[i], 
StockCode[i], Price[i]); 
ok = SQLOK(); 
} 
if (ok) 
{ 
EXEC SQL commit; 
ok = SQLOK (); 
} 
if (tok) 
EXEC SQL rollback; 


Figure 1 - A SQL Transaction using Embedded SQL/C 


ddd 


Transactions always succeed or fail in 
whole - partial transactions are never ap- 
plied to the database. 


Of course, transactions involve quite a lot 
of overhead. Usually the server writes infor- 
mation about each SQL statement to a trans- 
action log file. This information is sufficient 
for the transaction be unwound later. Since 
the log file is used for crash recovery, writes 
to it must be forced straight to disk, missing 
the benefit ofa disk cache (unless the cache 
is resistant to crashes or power failure). 


Transaction logs can be implemented in a 
number of ways. Where large transactions 
or large databases are involved, look for the 
following: 


@ Ability to connect to a database without 
transaction logging. This is vital for in- 
stallation or fixing of large databases 
where huge transactions involving 
megabytes or even gigabytes may be 
involved. 


Dynamic sizing of log file. Fixed size 
files are guaranteed to run out of space 
at just the wrong moment! 


@ Economic use of log file space. Some 


servers use far more space than is really 
needed. 


Locking Strategies 


Locking is used to sto 
the same record at the 
be extended to stop t 
same record on the 


two users updating 
same time. It can also 
wo users reading the 
basis that they may 


update it later. SQL servers implement lock- 
ing automatically, so the programmer is not 
concerned with manipulation of locks as 
with xBase systems. 


Granularity of locking can be important for 
peak performance. The best strategy is in- 
dividual row locking, where only the data 
needed during a transaction is locked. 
There is therefore usually a small chance of 
two transactions being deadlocked when 
they need to use the same record. 


Unfortunately some servers use page locks. 
Instead of locking a single row, they lock 
pages of, say, 2 KB, which may contain 
tens, or possibly even hundreds of rows. 
The chance of collision between transac- 
tions is therefore considerably higher - es- 
pecially on tables with small numbers of 
rows or columns. Often whole systems get 
bottle-necked on one or two critical small 
tables. Since a server will usually wait for a 
lock, this often manifests itself as greatly 
reduced application speed. If your server 
does page locks, you will need to be very 
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conscious of this during application design. 
It’s not impossible to write good fast appli- 
cations with page locking servers, but it can 
certainly be more difficult. 


Portability tips 


Most servers provide date, string and math- 
ematical functions. Use them as little as 
possible as they are completely non-stand- 
ard. Do it in the client instead. 


Most servers now support null valued col- 
umns (null means ‘never assigned’ and is not 
equivalent to zero or empty string). Some 
applications choose to have default values 
(eg empty string) applied to all unassigned 
columns instead, Whichever way you do it, 
make sure the server supports what you do, 
My advice would be to use null columns, as 
it is sometimes useful to test the unassigned 
state. Having said that, it is also useful if 
your client software automatically trans- 
lates nulls into default values when it reads, 
otherwise you will drive yourself crazy test- 
ing for null values everywhere. 


Query Optimisers 

Each server will have a query optimiser. 
This is a black box that interprets queries 
and decides on a query execution plan 


(QEP). 


Figure 2 is an example of a moderately 
complex join query that will extract infor- 
mation for making invoices. The server is 
entirely responsible for deciding how to 
access the three tables. Unlike file handlers, 
SQL statements are independent of any in- 
dexes there may be. The query optimiser 
must decide which indexes to use and in 
what order. Or perhap deciding whether 
sorting and matching should be done in 
RAM. There are many possibilities. 


Programmers used to file handlers have 
problems with query optimisers. They like 
to decide for themselves how data should 
be accessed. But by letting the server de- 
cide which way to do things we are free to 
add indexes at any time. Quite often the 
same program may he running databases of 
wildly different sizes which may require 
different sets of indexes. Or one particular 
site may make very heavy use of a particular 
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Practical SQL 


query. Their system can be speeded up by 
adding another index or two to make that 
query run faster. This requires no program 
changes - the query optimiser simply starts 
using the index once it is created. 


One thing that can help the query optimiser 
is statistics. Most servers include a program 
that is run every few days which collects 
statistics about the data in each table and 
index. Armed with this information, the 
query optimiser has a better chance of mak- 
ing a sensible decision. Of course, if data in 
a table is changing rapidly the statistics will 
get out of date quickly. 


Some query optimisers are more successful 
than others. All of them will make bad 
decisions from time to time. How much 
this matters will depend on the query 
involved, I have watched a server take 
minutes to run a query that should have 
completed in only a few seconds. There 
is not much you can do other than re- 
code things. Just don’t expect perfection 
from a query optimiser. 


Some server manufacturers let you in- 
fluence the query optimiser by writing 
your SQL in a particular way, eg in a 
multi-table join, the first named table 
might be accessed first. While this may 
seem a pragmatic solution to the problem 
of imperfect query optimisers, I believe it 
is a very bad thing. For a start, it lets the 
server manufacturer pass the buck to the 
programmer for query optimising. Sec- 
ondly, your chances of writing portable 
SQL are even further diminished by this. 
There is certainly no standard for query 
optimiser hints. 


The Major Players 


One problem we all come across is the 
attitude of server manufacturers. They are 
in the business of persuading customers to 
trust their most valuable data to their server. 
They really do not want to admit there may 
be bugs. And in some cases there have been 
a huge quantity of bugs! Bugs in servers are 
generally much worse than in other pro- 
ducts, especially when the database is very 
large. If your database goes inconsistent, it 
might take hours to recover from a backup 
or have someone patch the database. That 


select c.name, c.custcode, ih.invcode, 
it.stockcode, it.quantity, it. 

from customer c, invoice_header ih, 

invoice item it 

ih.custcode = c.custcode 
it.invcode = ih.invcode 
ih.invdate > '10/06/92' 
c.postcode like 'BS%’ 

by invcode; 


where 
and 
and 
and 
order 


price 


Figure 2 - Example of a join query 
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Hardlock E-Y-E®- tying the hands 
of software pirates 


The effective way to protect your software 
FAST Electronic has made life a lot harder for soft- 
ware pirates. Hardlock E-Y-E was designed using 
cryptographic principles. It took the experience 
and know-how of Germany's number one in soft- 
ware protection and the leading edge technology 
of a US semiconductor company to create the 
ultimate software protection tool. 


The technology programmers have at their 
fingertips 

Hardlock E-Y-E is based on a custom chip and 
combines all the features that a programmer 
would expect from such a device: secure, algo- 
rithmic query routines and an optional non-vola- 
tile memory for custom configurations. With the 
Crypto-Programmer card from FAST you can pro- 
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easy: you can either protect your .COM and .EXE 
files with the automatic encryption software 
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routines into your source code. 


Order your demo unit today. Contact Magnifeye, 
235-239 Walmer Road, Walmer Studio # 6, W 114 EY, 
Telephone 071 221 8024, Fax 071792 3449. 


Readily acceptable to your customers 

Hardlock E-Y-E allows unlimited backup copies 

of the master floppy. The customer gets the device 
together with the software and plugs it into the 
parallel port between the printer and the PC. Daisy- 
chainability, outstanding reliability and the compact 
high tech design guarantee that your customers 
will accept Hardlock E-Y-E. 


The benefits your management will appreciate 
Hardlock E-Y-E can be programmed by the soft- 
ware house 
with the 
Crypto-Pro- 
grammer card. 
This ensures 
optimum deli- 
very schedules 
and stock flexi- 
bility. Revenues 


will go up as 

software piracy 

and multiple Hardlock E-Y-E 

usage are programmable, algorithmic response 
prevented. and memory option - all in one 
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can be a disaster when an office full of users 
are waiting for it to go back on-line. So 
reliability is vital. 


But these are sophisticate pieces of soft- 
ware that get loaded down with new fea- 
tures each year and ported to several 
different operating systems. There are 
going to be bugs, so you should expect 
them. Forget what the salesman says and 
do not buy the idea that these are infallible 
products, 


The best advice is to use a hardware/oper- 
ating system/server combination that is 
known to work well. Wherever possible 
make sure you are using hardware that the 
SQL server manufacturer considers to be a 
‘Major’ platform. Increasingly I think this 
will mean the three or four major strains of 
UNIX, VMS and Netware. In some cases, 
‘Minor’ platforms can lag well behind and 
maybe never get a stable release. Of course, 
some of these decisions may have been 
taken for you. The best you can do is try 
and get first hand reports of someone else 
using the same combination, Itis possible you 
have a combination that just will not work 
properly - its best to hear about it in ad- 
vance rather than assume all will be well. 


So what do we have on the market? The 
major players are Oracle, Ingres, Sybase 
(OS/2 version rebadged by Microsoft), 
Informix, Rdb from DEC and DB2 from 
IBM. All these started in the mini/main- 
frame world, although they are now start- 
ing to take PCs much more seriously. 


Oracle is the market leader, with a huge 
number of ports and plenty of third-party 
add-ons available. A fairly safe choice if 
you want maximum portability but want 
to stick with just one server manufacturer. 


Gupta’s servers are a refreshing change, as 
they were designed from the outset to run 
on PC networks instead of minis. They are 
economical with memory and CPU and in- 
clude many extra features that can help 
write applications for GUIs, where many 
different forms and tables may be displayed 
at once. The newly released Netware NLM 
has suffered a few teething problems but 
should be an excellent choice for smaller 
systems when it settles down in a few 
months. Gupta has the distinct advantage 
of supplying a single user database (runs 
under DOS or Windows) which runs the 
full SQL and is brilliant for developers and 
Sales demos. 


Practical SQL 


Interbase from Borland is one to watch over 
the coming months. Its innovative design is 
said to be fast, especially with concurrent 
updates. Borland is supposed to be making 
Interbase one of the cornerstones of its new 
database strategy, and will be porting it to 
PC environments. 


Wrap-up 

I hope I have shown you some of the im- 
portant things to watch out for when writ- 
ing a client-server application for SQL. 
There is no substitute for experience itself, 
so try and get in touch with people who are 
doing the same thing as you. Many manu- 
facturers have user groups. Remember that 
you will need to get pretty well acquainted 
with each server you use and may have to 
re-code portions of your application for 
each server you port to. 


Andrew Terry is a director of Advance Sys- 
tems Ltd, a small Bristol based consultancy 
and software house specialising in client- 
server systems, Windows and C++. He can 
be contacted on 0272 427219, or 
100016,3414 on CompuServe. 
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SQL Server vs NetWare SQL 


SQL Server vs NetWare SQL 


Bob Walder looks at two of the latest releases in the PC LAN database server market. 


Networks have taken off in a big way over 
the last few years, and applications which 
once ran on large minicomputers or even 
mainframes are now running on large cor- 
porate networks, which offer a much more 
attractive price-performance ratio, Unfortu- 
nately, the very popularity and accessibility 
of networks can be their undoing with far 
more people making use of user-friendly 
PCs, thus swamping the networks with traf- 
fic- hence the increasing interest in the client- 
server approach, which reduces network 
trafficand increases the flexibility ofthe setup. 
The recent release of Microsoft SQL Server 
version 4,2 prompted us to take a look and 
compare it with the outwardly similar product 
from Novell - NetWare SQL version 3.0. 


SQL Server 


Announced in January of this year, version 
4,2 is a major enhancement of Microsoft’s 
SQL Server product. The release of 4.2 fi- 
nally brings both the version numbering 
and functionality in line with the Sybase 
SQL Server on which it is based, hence the 
leap in version numbers from the previous 
release, 1.11. 


Novell users may have pricked up their ears 
at the announcement that SQL Server not 
only runs across LAN Manager networks, 
but also IBM LAN Server, Banyan Vines and 
Novell NetWare. However, before reaching 


for your cheque book it is worth reading the 
small print. SQL Server is a native OS/2 
product, and thus needs to run on an OS/2 
server - it is not actually possible to install 
itas an NLM ona NetWare server. Although 
SQL Server does come complete with a 
server optimised version of OS/2, you 
would need a dedicated OS/2 PC running 
both SQL Server and the NetWare Reques- 
ter for OS/2 to use it on a Novell network. 
(However, the word is that the release of a 
native NetWare NLM version of Sybase SQL 
Server is imminent - it may even have hit 
the streets by the time you read this), 


The Software 


Installation of SQL Server takes the form of a 
simple question and answer session followed 
by some disk swapping. It requires a mini- 
mum of 8 MB of RAM to run, although if you 
are installing it on the file server, Microsoft 
recommends 16 MB or more for optimum 
performance. I had no problems running 
both LAN Manager and SQL Server on the 
same machine with just 8 MB of RAM, but I 
would not recommend this as a configuration 
to support more than a couple of users. 


Most of the installation questions are fairly 
innocuous, apart from the one which asks 
you to specify the sort order. Once you 
have set this (binary order, dictionary 
order, etc) it applies to all databases, and is 


set for good. The only way to change it is 
to re-install SQL Server from scratch - not 
an appealing prospect. As anyone who has 
designed databases will know, different ta- 
bles may well require different sort orders, 
and it would be far better to include this sort 
of choice in the ‘create table’ option. 


At this stage it is worth taking a few mo- 
ments to explain what SQL Server means by 
a ‘database’, since the physical implemen- 
tation is different from that used by pro- 
ducts such as NetWare SQL. Databases are 
actually stored on ‘devices’, which are logi- 
cal entities. Many devices can be created on 
a single physical disk, and devices can also 
be created on floppy disks or tape drives 
for backup purposes. Each device is ac- 
tually implemented as a fixed-length data 
file on the selected physical clevice. The size 
of the device must be specified at the time of 
creation, and this cannot be reduced without 
scrapping the device (and its databases) and 
re-creating it. This can be wasteful of disk 
space, since you are required to reserve space 
which is not actually used - it would be better 
ifthe allocation of disk space for devices were 
performed dynamically. 


Once a device has been created, it is 
possible to create a database, followed by 
the individual tables which make up that 
database. For instance, you may create a 
device called MAIN on which you create a 


Sub OK_BUTTON_Click () 


If Server_name$ 
MsgBox "Must supply a server name" 
Exit Sub 
End If 
If Login_id§ = "" Then 

MsgBox "Must supply a login id" 
Exit Sub 
End If 
Rem 


Rem Status’ = SqlSetLogi: 
Rem Get the server name, login Id, & password from the form SqlConn' 
Rem Password$, "VBSQL", 
Server_name$ = Server name field.text If SqlConnt <> 0 Then 
: .text GetDatabaseName 
.text MAINFORM.Caption = 


Sub CANCEL_BUTTON_Click 
Login. Hide 

End Sub 

Sub GetDatabaseName () 


If SqlConnt <> 0 Then SqlClose (SqlConnt 


SqlOpenConnection (Server_name$, Login_id$, 
"VBSQL") 


Server_name$ + "/" + Dat 
Result5 = Sqlset’ 
End If 
Login.Hide 
End Sub 


nTime (30) 


"VBSQL Sample Query Tool - " + 
abase_name$ 
Times (60) 


0 


Rem Check if the connection is live, if so, then close it 
Rem Set the max time to login to 30 seconds 

Rem Open the new connection 

Rem Change the caption of the application to reflect 

the server name and the database 

Rem Set the max time we will wait for a SQL Server response 
Rem 


End 


cmd$ = "Select db_name()" 

If SqlCmd(SqlConn%, cmd$) = FAIL Then Exit Sub 

If SqlExec(SqlConnt) = FAIL’ Then Exit Sub 

If SqlResults(SqlConnt) = FAIL’ Then Exit Sub 

While SqlNextRow(SqlConn%) <> NOMOREROWS% 
Database_name$ = SqlData(SqlConnt, 1) 

Wend 

sub 


Figure 1 - Connecting to SQL Server in a Visual Basic program 


26 .EXE Magazine, Vol 7, Issue 2, July 1992 


vr Nu-Mega 
TECHNOLOGIES INC| 


7 


Debug Windows at the systems level! 


Soft-ICE/W takes you inside Windows! Debug and explore with power 
and flexibility not found in any other Windows debugger! Soft-ICE/W 
allows you to debug at the systems or applications level or simply learn 
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WHAT THE EXPERTS ARE SAYING 


“Soft-ICE for Windows is great! It helped me 
find, in fifteen minutes, a killer bug in a 
Windows virtual device driver that had 
eluded two people for several months. | 
can't see doing Windows development of 
any kind -- whether writing Windows 
applications, device drivers, or even DOS 
programs that have to run under Windows -- 
without it. In addition to being great for 
finding bugs, Soft-ICE for Windows has been 
essential for my work on a forthcoming book: 
on Undocumented Windows. Soft-ICE for 
Windows goes anywhere and does 
everything, so it's essential for anyone who 
wants to poke around inside Windows 
Enhanced mode. DOS programmers will find 
it a perfect way to learn how the Windows 
DOS extender and DPMI server work, and 
how Windows interacts with DOS. Windows 
Enhanced mode is the hacker's paradise of 
the 90s, and Soft-ICE for Windows is the tool 
that every serious Windows or DOS hacker 
willneed. Nu-Mega has done a brilliant 
job!” 


Andrew Schulman 
Software Engineer, Phar Lap Software 

Editor, Undocumented DOS 

Coauthor, Undocumented Windows (forthcoming) 


[ADVANCED BUSINESS GRAPHICS 


LL 


T REE 
Tile View Manage 
Current Connnetions 
HAVE MAR 


Window telp 


Semen LLCS BE SULLA 


San 


authors 


sia) oe 


Sears ‘ 


database called SOP (Sales Order Process- 
ing). Within the SOP database you would 
then create all the necessary tables such as 
CUSTOMER, ORDERS, PRICES, etc, but on 
your physical disk drive all you would see 
is the single file MAIN.DAT. On installation, 
the SETUP program creates the Master De- 
vice (MASTER.DAT) which contains the 
MASTER database and system tables which 
control the user databases and the oper- 
ation of SQL Server as a whole, keeping 
track of user accounts, remote servers, con- 
figurable variables, databases, devices and 
active locks. Just as with LAN Manager it- 
self, user accounts and groups can be cre- 
ated and assigned permissions which 
restrict their use of databases. Guest privi- 
leges can be set up to allow casual users 
access to your database files. 


Security 


Data security and fault tolerance are par- 
ticularly well implemented on the new ver- 
sion of SQL Server. Any or all of the logical 
devices can be mirrored on different physi- 
cal devices. Software mirroring like this can 
be much more economical on disk space 
than hardware mirroring which forces you 
to duplicate an entire volume - wasteful if 
only part of it contains live data. However, 
software mirroring does not allow applica- 
tions to keep on running if an entire disk 
fails. Hardware mirroring of a volume does, 
and can also offer better performance since 
the database server itself is not required to 
perform ‘dual writes’. 


A farther enhancement in the area of se- 
curity is the ability to perform dynamic 
backup to tape devices, which ensures that 
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Figure 2 - A WinSQL screen 


SQL Server stays up and running during 
database backup, even while users are ac- 
tively using the system. All transactions ex- 
ecuted on the system are not only written 
to the database itself, but are also written to 
transaction logs. This allows uncommitted 
transactions to be ‘rolled back’ in the event 
of mishaps, and can also allow any number 
of transactions to be ‘rolled forward’ from 
the last backup to the exact point of failure. 


At the processing level, referential integrity 
is assured by the use of triggers. These are 
SQL procedures which are stored in a data- 
base and activated when certain conditions 
are met. For instance, if an application at- 
tempts to delete a customer record, a trigger 
can be activated to check if there are any 
outstanding orders for that customer, and 
prevent the deletion if there are. Ina similar 
way, a deletion of an order header record 
can automatically trigger the deletion of all 
the order line ‘child’ records, thus preserv- 
ing integrity. Cascading triggers can be 
nested to a depth of 16 levels. 


The Administratot’s task 


Moving on from the security aspects, there are 
a great number of system procedures in- 
cluded as part of the package. These are once 
again pieces of SQL code, stored in the master 
database, which can greatly ease the burden 
of the database administrator by automating 
commonly used reporting and maintenance 
routines. Over 70 such procedures are sup- 
plied, and they are all fully documented in the 
excellent Language Reference Manual. 


Life for the database administrator has been 
further simplified with the inclusion of a 
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Windows based System Administrator 
Function (SAF), now called WinSQL (Fig- 
ure 2), SAF is still supplied as a DOS based 
programas well, but the Windows interface 
certainly adds to its user friendliness. This 
program allows the administrator to per- 
form such functions as creating devices, data- 
bases and users, as well as backing up and 
restoring databases without actually dirtying 
his hands with SQL or system procedures. 


A query window allows the creation of SQL 
queries which can then be submitted to the 
server, the results being returned in another 
window. This is a nice feature and, together 
with the bulk copy program (which can 
load data from ASCII files into SQL Server 
databases) provides a means to populate 
and query SQL Server databases without 
investing in a front-end product. 


Front-end 


Front-end applications, however, are what 
it’s all about - no end user wants to interact 
directly with the database engine. There are 
many front-ends available for SQL Server, 
notably SQL Windows, DataEase, Clipper 
and dBase IV. There are also APIs available 
for programming languages such as Micro- 
soft’s Visual Basic. 


The Visual Basic Library for SQL Server now 
allows the VB programmer to write serious 
applications without having to worry about 
the basics (no pun intended) of how the 
data is handled, Features such as VB’s 
browse mode and the new scrollable data- 
base cursors available under SQL Server 4.2 
make programming sophisticated data 
handling applications under Windows a 
simple matter, Figure 1 shows just how 
simple it can be. 


Netware SQL 3.0 


Though you may not be aware of it (due to 
a distinct lack of marketing effort within the 
UK) Novell has its own database server 
product called NetWare SQL. In an attempt 
to keep up with Microsoft/Sybase, Version 
3 of NetWare SQL has just begun shipping. 
Unfortunately, deadlines arrived before I 
was able to perform an in-depth evaluation 
of the new product (ie I was not able to 
benchmark the two products side by side), 
but here is an idea of what you can expect. 


NetWare SQL actually splits its database 
management and record I/O functions into 
two distinct modules. Record I/O is per- 
formed by the ubiquitous Btrieve, Novell’s 
key-indexed record management system 
which is shipped as part of the NetWare 
package. This allows many sites to use 
existing Btrieve files as part of their Net- 
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Ware SQL applications, using a wide variety 
of front-end tools to make data from ac- 
counting and sales management packages 
available to the rest of their organisations. 
It is also possible to write custom enhance- 
ments to commercially available packages 
using NetWare SQL, directly reading from 
and writing to the application data files. 
Finally, NetWare SQL provides a relatively 
painless migration from stand-alone to net- 
worked applications. For example, if you 
have a Clipper application running on your 
stand-alone PC, you can convert your data 
to Btrieve and use NetWare SQL to run that 
application from your network, 


Btrieve itself has been around for some 
years, and is a tried and tested product 
offering extensive data integrity and se- 
curity features. Transaction processing is 
used to maintain consistency during 
multiple file updates, and ‘logging and roll- 
forward’ processes record file operations 
and recover data corrupted by a system or 
server failure, NetWare SQL used to make 
use of NetWare’s Transaction Tracking Sys- 
tem (TTS) to protect databases from corrup- 
tion by backing out of incomplete 
transactions that resulted from network 
failure. This is not necessary with Btrieve 
V6.x (as supplied with the current version 
of NetWare SQL) since Btrieve itself now 
uses a transaction tracking system which 
involves appending new pages to the end 
of the file and using a Page Allocation Table 
(PAT). If an error occurs and Btrieve must 
roll back to the beginning of the transac- 
tion, it merely resets the location pointers 
in the PAT to the settings before the trans- 
action took effect. 


All record and file level locking is also per- 
formed by Btrieve, whilst its pre-imaging 
techniques store images of file pages before 
records are inserted, updated or deleted, 
further protecting against data loss. On the 
security side, Btrieve allows owner names 
to be assigned to files, and permits dynamic 
encryption and decryption of data. 


The SQL component 


NetWare SQL itself is also implemented as 
a VAP/NLM and the first NLM to ship for 
NetWare 386, It is actually a server-based 
implementation of the XQL Relational Da- 
tabase Manager, a multi-level database de- 
velopment system that allows a 
programmer to implement a relational da- 
tabase in two ways. XQL can either use SQL 
statements or a set of program function 
calls, known as relational primitives, which 
bypass SQL statements. NetWare SQL im- 
plements most of the features of both ANSI 
SQL and IBM’s SAA SQL, and also provides 
some inevitable extensions. 


A Developer's Kit available provides APIs 
for various implementations of BASIC, Pas- 
cal, Cand COBOL in the DOS environment. 
In addition to this, there are OS/2 and Win- 
dows APIs, using the supplied DLL as an 


MMU le 


Data security 
and fault 
tolerance are 
particularly well 
implemented on 
the new version 
of SQL Server 


UMUC 


interface between the Windows applica- 
tion and the DOS Requester - so once again 
you can use Microsoft's Visual Basic as a 
Windows front-end. Calls to NetWare SQL 
can either use embedded SQL statements or 
direct function calls to the relational primi- 
tives. As well as these APIs, Novell also 
supplies the Gupta SQLRouter, the Lotus 
DataLens Driver and the Data Access Lan- 
guage (DAL) Server, which enables Macin- 
tosh users to access NetWare SQL data from 
applications written in Apple’s DAL. 


Data under NetWare SQL is handled in a 
more conventional way than SQL Server. 
The data itself is stored in .DTA data files, 
and these can be spread across a number 
of servers if required, the necessary inter- 
server communications being handled auto- 
matically by the BROUTER portion of Btrieve. 
Dictionary files (suffix .DDF) contain infor- 
mation about the database, such as table 
names, field names, field types and indexes. 
‘Continuous operation’ is a new Btrieve 
feature that allows files to be backed up 
while they are in use by clever use of tem- 
porary files (and lots of disk space - so be 
carefull). The NetWare SQL Backup Sup- 
port Program allows you to use NetWare’s 
SBACKUP utility (or indeed any other which 
uses NetWare’s Storage Management Ser- 
vices), to back up data from a number of 
database servers to a single server which 
has backup capabilities. Itis worth noting that 
Novell’s concept of named databases allows 
you to move databases between servers with- 
out having to alter your applications. 


Still on the theme of security, is nice to see 
that version 3.0 of NetWare SQL finally in- 
cludes declarative referential integrity, Un- 


SQL Server vs NetWare SQL 


like the SQL Server method of using stored 
SQL procedures as triggers, NetWare SQL 
provides extensions to the CREATE 
TABLE statement which allows you to 
specify which foreign keys are in use, 
which tables they reference and what 
should happen when an attempt is made to 
delete a parent record, Once such relation- 
ships have been defined, NetWare SQL 
automatically ensures that all primary and 
foreign keys are kept in line wherever 
necessary, and can either prevent deletions 
or cause cascade deletions where it is necess- 
ary to remove all child records on deletion o 
a parent. I must confess to preferring the SQL 
Server method, since there seems to be an 
inherent flexibility in the stored procedure 
method which is lacking here. 


As a final point, it is worth noting that Novell 
has finally woken up and included a number 
of useful utility programs as part of the Net- 
Ware SQL package, similar to those included 
with SQL Server. SQLScope is an interactive 
Windows-based workstation application for 
editing and submitting SQL statements to the 
server, which works more as a ‘query by 
example’ system and less as an administration 
function 4 la WinSQL. To go one better, 
Novell has included a copy of Xtrieve Plus, a 
sophisticated data management program. 
Also included as part of the standard package 
are monitoring tools, a program for bulk im- 
port/export of data, rollforward, maintenance, 
backup and referential integrity verification 
programs, amongst others. As a final plus 
point, there is even a single user run-time 
version of NetWare 3.11 so that you can run 
your NetWare SQL on a dedicated server. 


Conclusion 


At the end of the day, these products are now 
so similar that it may well come down to a 
simple choice of whether you have a NetWare 
or LAN Manager network. I would be equally 
happy working with either of them. 


EXE! 


Bob Walder is the co-founder of ComNet, 
an independent network consultancy who 
specialise in all things network-relaled, in- 
cluding client-server technology. 


SQL Server 4.2 is available from Microsoft 
on 0734 270000. A 10-User System costs 
£2295, Programmer's Toolkits for C, Visual 
Basic and COBOL cost £335, as does the 
Administrator for Windows. 


NetWare SQL 3.0 is available from System 
Support on 0306 740662. To get started 
you'll need a NetWare SQL 3.0 5-User NLM 
(£690) and a NetWare SQL Developer's Kit 
V3.0 (also £690). 
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Deductive Databases 


OO databases are often cited as the next great advance. But Ted Walker bas an alternative 
suggestion, which extends the notion of a relational database table to encompass rules. 


‘A deductive database system is a generali- 
sation of a relational database system that 
allows data to be represented both explicit- 
ly by stored facts and implicitly by general 
rules.’ - Topor, Keddis, Wright 1984. 


In this article I will be describing a deduc- 
tive database system. I will show how data 
is represented, how queries are expressed 
and the database modified, demonstrating 
the correspondence with standard relational 
database systems. Then I will explain how 
rules are supported and show how the re- 
sulting system can be used as general purpose 
programming language, avoiding the need to 
resort to a separate application language. 


Data Representation 


Figure 1 shows a simple customer table, 
and the code to represent it in a deductive 
database system. Anyone familiar with a 
relational database will immediately see 
how to represent this in their own system, 
be it dBASE, Paradox, Oracle or whatever. 


Notice that I did not need to predefine the 
table in terms of number of fields, field 
names, lengths and types. Each record 
starts with the name of the table to which it 
belongs. The values follow as a comma 
separated list within brackets, The record 
ends with a full stop, and so can be split 
over several lines. The correspondence be- 
tween the rows and columns of a table is 
plain to see. 


The values themselves deserve some expla- 
nation. You will notice that all the words 
are written in lower case. There are actually 
several types of values that can be repre- 
sented, Integers and reals are as you would 
expect. Unrestricted strings must appear in 
double quotes, but there is a fourth simple 
type: atoms. These are represented more 
efficiently than strings, but can only consist 
of alphanumeric characters, the first of 
which must be a lower case letter. The table 
name must be an atom. 


Figure 2 shows some other tables to be used 
in the examples as we go along. Note that 
comments can appear within the slash-as- 
terisk delimiters. 


Querying the Database 

Relational databases are usually queried 
using some form of relational algebra, 
Oracle, for example, uses SQL, but there are 
alternatives. Paradox uses an approach 
sometimes called Query By Example 
(QBE). We use something technically 
referred to as a tuple-oriented relational 
calculus, which sounds formidable, but is 
in fact extremely simple. 


The first thing to remember is that, unlike 
usual queries which produce a table of 
results, these queries produce their solu- 
tions a record ata time. This is similar to the 
SQL notion of a cursor. Of course, it is 
possible to collect the solutions and store 


Customer 
ID Name Status Location 

1047 Tony 10 Bristol 
1038 | Dick 30 Oxford 
1036 Nick 20 Bracknell 
1028 Ted 10 Oxford 

customer (1047, tony, 10, bristol). 

customer (1038, dick, 30, oxford). 

customer (1036, nick, 20, bracknell). 

customer (1028, ted, 10, oxford). 


Figure 1 - An example Table, and the code to represent it 
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them in a new table, but the underlying 
conceptis to find one solution ata time. The 
way the query is made is very similar to 
QBE, in that matching criteria are placed in 
the appropriate position ina table template. 


Perhaps some examples will help make 
things clearer, In each example, we state an 
English form, then show how this would be 
represented both in SQL and in the deduc- 
tive database. 


Simple retrieval: Get full details of all cus- 
tomers. 


SELECT * 
FROM CUSTOMER 


2- customer (ID,Nm,St,Locn). 


A query is prefixed with the question-mark- 
minus symbol. This query is made up of a 
template for the customer table. The system 
will handle the query by attempting to 
match this template against the records in 
the table. The words in the value positions 
in this template all start with an upper case 
letter, which is how we denote a variable. 
When the template is matched against a 
record, the variable is bound to the actual 
value in that position in the record. If the 
template matches with a record we say it 
succeeds, and we can inspect the value of 
the variables. If it does not match we say it 
fails. This query will succeed for each rec- 
ord in the customer table. 


Qualified retrieval: Get names of customers 
in Oxford with status greater than 20. 


SELECT NAME 

FROM CUSTOMER 

WHERE LOCATION = ‘OXFORD’ 
AND STATUS > 20 


?- customer (_,Nm,St, oxford), 
St 2-20. 


This query is made up of a table template 
and another condition. Notice that the first 
position in the customer template is the 


underscore symbol, which indicates that 
we are not interested in that field. The atom 
oxford appears in the last position of the 
template. This will therefore only match 
with records having oxford as the value 
in that field. The comma outside the tem- 
plate is how we write AND to conjoin two 
queries. The second part of this query is a 
condition on the Status variable, namely 
that the value it has matched in the cus- 
tomer record must be greater than 20, 


Complex Query: Get name of customers 
who have ordered at least those products 
ordered by 1047. 


SELECT UNIQUE NAME 
FROM CUSTOMER CX 
WHERE NOT EXISTS 
(SELECT * 
FROM ORDER OY 
WHERE CUSTID = 
AND NOT EXISTS 
(SELECT * 
FROM ORDER 
WHERE CUSTID = CX.ID 
AND PRODID = OY.PRODID 
) 


1047 


) 


?- customer (ID,Name, ,_), 
not ( 
order (1047,P,_), 
not order (ID,P,_) 
). 


Find ID and Name from a customer record 
such that there is not a product P ordered 
by 1047 which is not itself ordered by ID. 
When we use the same variable name in 
different templates it means that the value 
must be the same in both. The query also 
shows the use of another logical connec- 
tive, not, which succeeds if b-query 
fails. We can also connect queries using an 
OR operator, which is written as a semi- 
colon. 


It should be clear that this system offers a 
very neat way of performing arbitrarily 
complex queries on the database. It is 
usually more succinct than its relational 
algebra equivalent, and is more expressive 
than QBE. 


/* product ( ID, Name, Class, Price ) */ 


product (204, sausage, meat, 2.56). 
product (307, lentils, veg, 0.72). 
product (136, potatoes, veg, 1.12). 
product (207, chicken, meat, 1.09). 
product (147, cabbage, veg, 0.47). 


/* order( CustID, ProdID, Quantity ) */ 
order (1047, 204, 8). 
order (1047, 207, 1). 
order (1028, 307, 4). 
order (1028, 147, 1). 
order (1036, 136, 5). 
order (1036, 207, 1). 
order (1036, 204, 6). 


Figure 2 - 
Two more example Tables 


Updating the Database 


There are commands for dynamically mod- 
ifying a table, that is to change the table 
from within a query. ‘lo add a new record 
toa table we use assert: 
?- assert ( customer (1033, 

jim, 


40, 
oxford 


). 


To remove a record from a table we use 
retract: 


?- retract ( customer (_, 


). 


This will successively remove all records 
from the customer table that match the tem- 
plate. 


Beyond Relations 


So far we have only shown the ways in 
which this system is like a relational data- 
base. Now let’s see how it differs, and what 
that allows us to do, 


Probably the most important extension is to 
allow a record to take the form of a rule. 
The rule can be read as saying that a certain 
pattern of values exists in the table if certain 
conditions are met, where the conditions 
might be queries on other tables, 


For example, this can be used to offer a 
restricted view of the data. If we wanted to 
hide the Status column in the Customer 
table we could define a new view of it as 
follows. 


simpleCustomer (ID,Nm,Locn) :- 
customer (ID,Nm,_,Locn). 


The record is split over two lines; the full 
stop marks the end of the record. The 
range colon-minus symbol is the way we 
write ‘if, That is the only record we need 
for simpleCustomer, and it says the 
simpleCustomer relation holds be- 
tween any values of ID, Nm and Locn if 
there is a record corresponding to those 
values in the Customer table. Our first rule! 


A rule can also be used to derive new 
information. Suppose we want to classify 
our customers into vegetarians and meat 
eaters; we could do this as follows: 


diet (Name, eatsmeat) :- 
customer (ID,Name,_,_), 
order(ID,P,_), 
product (P,_,meat,_). 

diet (Name, vegetarian) :- 
not diet (Name, eatsmeat). 


Deductive Databases 


This table is made up of two records, both 
of which are rules. The first says that 
somebody eats meat if they are associated 
with ID in the customer table and there is 
an order by LD for b, and P is classified as 
a meat product in the product table. The 
second rule says that Name is a vegetarian 
if we cannot show that they are a meat 
eater. 


The second major extension is in the sup- 
port of structured data. Relational data- 
bases are required to hold their data in First 
Normal Form, which means that all the data 
values appearing in a table must be atomic. 
Our system supports non-atomic values in 
the form of structures. A structure is a col- 
lection of other data values. If we are group- 
ing together a fixed number of values, we 
give the structure an atomic name and have 
the values as a comma separated list within 
brackets, just like the format for a record. 
For example, we could extend the order 
table with a date column as follows 


order( 1027, 
20 


, 


8 
date (25, 12, 1992) 
i 
If we are grouping an indeterminate num- 
ber of data values, we put the values in a 
comma separated list within square brac- 
kets. This is called a list and does not re- 
quire an atomic name. For example we 
could have a table of things people eat as 
follows 
eats ( nick, 
{ sausage, 
chicken, 
potatoes 
] 
). 
A unique feature of lists is that we can 
distinguish between the first element of the 
list and the rest of it, using the vertical bar 
‘|’ symbol. For example in the query 


?- eats(nick, [X|Y]). 


will succeed with X bound to the atom 
sausage, and Y bound to the list 
(chicken, potatoes]. 


The key point of this article is that, with 
these two extensions, the relational model 
is not only good for data, it can used for 
programs as well. Such programs are 
usually made up of a large number of small 
tables, rather than the small number of large 
tables found in a typical database. 


Here is a program that can be used to check 
if a value is present in a list. 
member (El, [El|_]). 
member (E1,{_|Tail]) :- 
member (E1,Tail). 


The first record says a value is in a list if it 
is the first element of that list. The second 
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record says a value is in a list if it is some- 
where in the list after the first element. It is 
a recursive definition where a query on a 
list of some size is reduced to an equivalent 
query on 4 list one element shorter. A query 
with a variable in the first position, and a 
list in the second, will succeed for each 
element of the list, binding the variable to 
that element. This is a common technique 
for iterating over the elements of a list. A 
query in which both positions are non-vari- 
able will succeed if the first is a member of 
the second and will fail otherwise. 


?- member (X, [3,2,1]). 
?- member (1, [3,2,1]). 


Imagine doing that in your usual database 
application language. 


A Programming Language 

It is time to own up. The language is Prolog. 
Wait! I know what you are thinking: ‘That's 
that obscure language used for Artificial 
Intelligence.’ I urge you to forget all you 
have heard. It is an historical accident that 
Prolog has those connotations. The people 
who originally developed the language 
were academics working in the fields of 
computational linguistics and automated 
theorem proving. It is true that it is very 
good at those sorts of complex symbolic 
tasks, but it is good for other things too. 


I have already shown that you can apply 
many of the concepts you have learnt with 
your database system to Prolog. Because of 
its history, Prolog uses a different jargon to 
that of relational databases, so let’s explain 
how to map between the two. In a rela- 
tional database one talks of data being rep- 
resented ina table, or sometimes a relation; 
in Prolog this is usually called a predicate, 
although it is also sometimes called a rela- 
tion, The fields/columns of a table are 
called the arguments of a predicate. The 
number of arguments a predicate takes is 
called its arity, A record or row ina table is 
called a clause of a predicate. 


Prolog has been commercially available for 
more thana decade. That’s a lot longer than 
Paradox, so why aren’t people using it for 
all their database applications? There are 
some very good reasons. Current im- 
plementations of Prolog are optimised as 
programming languages, rather than as da- 
tabase systems. 


First, the Prolog database is memory resi- 
dent. It is read in its entirety from file into 
memory, and then at the end of the session 
can be written, again in its entirety, back to 
disk. It will not update the file on disk on a 
record by record basis. Second, the index- 
ing mechanism is usually restricted to the 
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first field of each table; this can be a serious 
performance disadvantage for large tables. 
Third, the Prolog database cannot be sim- 
ultaneously shared by several applications. 


DLL deedeeedeeeceeeedeeeeeceededeeeeddedddda 
It is time to own 
up. The language 
that I have been 

describing is... 


UU 


Most Prolog systems include interfaces to 
database systems, to provide those data- 
base facilities that we have just identified as 
not directly supported. Since both systems 
have the same conceptual structure, the 
interface between the two is quite natural. 
Such hybrid systems are referred to as loosely 
coupled deductive databases, since the pro- 
grammer needs to be aware of what is stored 
on the Prolog and the database sides of the 
interface. Tightly coupled deductive database 
systems are still at the research stage, for 
example the Datalog system from the Euro- 
pean Computer Research Center in Munich, 
but they are coming. 


Prolog is being used on thousands of real 
problems right now. One system that 
makes good use of its in-built database 
facilities is Tarifica. Itwas developed entire- 
ly in Prolog-2 for Windows by Intelidata 
Ltd, an offshoot of Logica. Its purpose is to 
advise on the cost of setting up and running 
international data communication net- 
works using existing satellite and other 
links. 


The company already compiled a large ring 
bound volume of tariff data, but this defied 
all attempts at computerisation. The tables 
were complicated by a large number of 
footnotes that adjusted the tariffs under cer- 
tain circumstances. Also, the information 
was continually changing as the services 
were updated. Prolog provided a solution. 
It allowed the underlying tables to be 
augmented with rules encapsulating those 
footnotes. This natural representation 
made the task of updating the information 
much easier. Tarifica is now a commercially 
available product. 


It is an exciting time in the Prolog world at 
the moment. There are several important 
developments besides the deductive data- 
base work I have already mentioned. There 
is a draft ISO standard for the language, 
which will provide application developers 
with a degree of independence from indi- 


Deductive Databases 


vidual suppliers. Prolog is also being ex- 
tended. We are beginning to see commer- 
cial systems that exploit parallel hardware, 
for example Parlog, and others which em- 
ploy constraint technology, like CHIP. But 
they deserve articles to themselves. 


Conclusion 


I am not suggesting you abandon your fa- 
vourite database system for straight data- 
base applications. My point is that Prolog is 
a language that uses the same concepts and 
yet allows you to do things well beyond the 
capabilities of your existing database sys- 
tem. 


Alan Turing showed that all programming 
formalisms are of equivalent computational 
power, the difference being in the ease with 
which a task can be accomplished. In this 
respect Prolog offers some advantages. Its 
clean, simple, declarative approach has 
been shown to reduce development time 
and make maintenance easier. Also, as has 
long been argued for structured methods, 
tools that control complexity allow more 
complex problems to be addressed, Prolog 
is being successfully used in some of the 
most complex fields of computer science. 


T hope I have convinced you that Prolog is 
not a weird language for weird applica- 
tions. It is a powerful general-purpose pro- 
gramming language. 


EXE. 


Ted Walker is a consultant with Expert 
Systems Ltd. He has been using Prolog since 
1983, sometimes (he now admits) for Arti- 


ficial Intelligence applications. 


Expert Systems Ltd produces a range of 
Prolog systems for Windows, DOS, VMS and 
UNIX. It can be contacted on 0865 784474. 
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lag 1989. 


Tom Conlon - Programming in Parlog, 
Addison Wesley 1990, 


CJ Date - An Introduction to Database 
Systems (5th Edition), Addison Wesley 
1990, 


Tony Dodd - Prolog: a logical approach, 
Oxford University Press 1991. 


Pascal van Hentenryk - Constraint satisfac- 
tion in Logic Programming, MIT Press 1989. 


Robert Lucas - Data Base Applications 
Using Prolog, Ellis Horwood 1988. 


there’s a light at the end of the tunnel 


Do you find you're being engulfed by trying to manage 
change, but think that using a configuration management tool 
would be an even bigger headache? It doesn’t have to be 
that way. There is a system which can make all of this 
manageable. Configuration management tools from Intasoft 
provide effective, easily implemented solutions across a range 
of platforms which will improve your productivity, reliability and 
quality. 


Available for: MS-DOS, Unix, VMS, OS/2, OS-9 
Tel: 0392 217670 Fax: 0392 437877 


Intasoft’s Software Management System (SMS) provides a 
complete, integrated suite of tools that takes the hard work out 
of managing change. The tools included cover version control, 
configuration management and building, and modification 
request management. 


See the light! Call for further details. 
MS-DOS Prices: 1 User £490, 5 Users £980 


Jymsoer 


Quality tools for 
professional software developers from 
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Help Software Productivity and 
painlessly improve your Software 
Quality System. 
w= Know which files comprise 
a complete system, at any time. 
m= Control source, object, 
binary, dBase files and documents. 
mas Recover code from uninten- 
tional changes. 
w= Quickly locate bugs introduc- 
ed during software development. 
w= Retrieve any prior version, or 
release of your software system. 
wes Highlight the revisions to 
ASCII & dBase format files and 
comment those changes with 9k’s 
Unique Split Screen Differential 
Analyser. 

Optional File 
Compression 

Unlimited Multiple 
branching 

Menu or a command 
line interface with on- 
screen help 

Full reporting and 
more... 


At last! A Version Control System 
that fits in with the way you work 
and is a joy to use! 

@ 9k costs just £149.00 

@ 30 day money back guarantee 


developers 


Especially recommended for xBase 


To place an order, request a demo 
disk or for further information call: 


9k. VERSION CONTROL 
WITHOUT TEARS 


QBS Software Ltd, 

10 Barley Mow Passage, 
London W4 4PH. 

Tel: 081-994 4842 

Fax: 081-994 3441 . 
bbs: 081-747 1979 


Forté Software Tools Ltd, 
Hunsdon House, Walford, 
Ross-on-Wye HR9 5SB. 
Tel/Fax: 0989 767656, or: 
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NetBios 


The NetBios Interface - 
Datagram and Status 


After last month’s introduction to NetBios, Derek Clifford explains the use of datagrams, and 
the commands available to investigate the state of the network adapters. 


Datagrams are messages sent to all users of a 
network (broadcast datagrams), or toa group 
or single user, by specifying a group or 
unique name as the destination. Datagrams 
offer no guarantee of reception, and should 
thus be used with caution, A typical applica- 
tion of Datagram transmission might be to 
inform all users that the LAN server was being 
closed down. For applications such as file 
transfer, the more secure mechanism of ses- 
sion communication should be used. 


The commands available for Datagram sup- 
port are: 


@ Send Datagram 

@ Receive Datagram 

@ Send Broadcast Datagram 

@ Receive Broadcast Datagram 

These commands are shown in Figure 1. 
The Send Broadcast Datagram specifies the 


name number of the sending adapter being 
used, and will be received by any station 


Code Command 

20H Send Datagram 

21H Receive Datagram 

22H Send Broadcast Datagram 
23H Receive Broadcast Datagram 


Figure 1 - 
NetBios Datagram Commands 


Code Command 
32H Reset 
33H Adapter Status 
70H Unlink 

Figure 2 - 


NetBios Miscellaneous Commands 
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which has a Receive Broadcast Datagram 
pending. The Receive Datagram command, 
however, specifies the local name number 
for which the datagram is addressed, and 
the datagram will only be passed to the 
application if it is destined for that name 
(which may bea group name, and therefore 


WU 
Warning - 
There is no 
guarantee of 
reception of a 
Datagram 


MULL 


received by other workstations). A special 
case exists which allows a datagram to be 
received if it is destined for any name in the 
local adapters name table. This is achieved 
by specifying the name number 255 in the 
Receive Datagram command (Receive- 
Any). If both a Receive Datagram for the 
specified name, and a Receive-Any com- 
mand are pending, the Receive for a spe- 
cific name takes priority. 


A word of caution 


Although the easiest method of receiving 
transmissions may appear to be the catch- 
all Receive-Any-For-Any, such requests 
should be used carefully in situations 
where a network server is operating, as 
such requests may have been initiated by 
the file server itself. Itis always safer to issue 
requests with specific unique or group 
names, thus avoiding any possible conflict 
with the server. 


lude <dos.h> 
clude <stdio.h> 


include <net.h> 
stru NCB Add_Name_NCB, Transmit, NCB; 
char ge [50] 


smit Datagram Mes: 
e [16] = "Transmit 
Sall_Name (16) = "Rec: 
uchar Local_Name_Number 
char far *Message Pointer; 
main() 
{ 
/* Initialise the two NCB structures */ 
InitNCB (&Add_Name_NCB) ; 
InitNCB(&Transmit_NCB) ; 
/* Add the unique name "Transmitter" */ 
Add_Name_NCB.NCB_Command_Code 
- NCB_ADD_NAME; 
strnepy (Add_Name_NCB.NCB_Local_Name, 
Name, strlen (Name) ); 
NetBiosCall (&Add_Name_NCB) ; 
/* Test for success */ 
if (Add_Name_NCB.NCB_Return_Code != 0) 
( 
print£ ("\n02x Add Name Failed, \ 
Error Code = ", 
Add_Name_NCB.NCB_Return_Code) ; 
exit (1)7 
) 
Local_Name_Number 
Add_Name_NCB.NCB_Name_Number; 
/* Send Datagram from 
"Transmitter" to "Receiver" */ 
‘Transmit_NCB.NCB_Command_Code 
7 NCB_SEND_DATAGRAM; 
Transmit_NCB.NCB_Name_Number = 
Local_Name_Number; 


Message Pointer = (char far *) &Message; 
Transmit_NCB.NCB_Buffer Offset = 
(char *) FP_OFF (Message Pointer) ; 
Transmit_NCB.NCB_Buffer Segment = 
(uint) FP_SE ge_Pointer); 
‘Transmit_NCB.NCB_Buffer_Length = 
strlen (Message) ; 
strnepy (Transmit_NCB.NCB_Call_Name, 
Call Name, strlen (Call_Name)); 
NetBiosCal} (&Transmit_NCB) ; 
/* Check for fatal errors, but no 
indication that Datagram 
is received */ 
if ( Transmit_NCB.NCB_Return_Code != 0) 
{ 
printf ( 
Error Code ' 
Transmit_NCB.NCB_Return_Code) ; 
exit (1); 
) 
printf ("\nDatagram Transmission \ 
Successful") ; 
/* Delete the name added, or the next 
attempt to run program will fail */ 
Add_Name_NCB.NCB_Command_Code = 
ELETE_NAME; 


n02X Datagram failed, \ 


NetBiosCall («Add_Name_} 
) 


Figure 3 - Datagram Transmit Application 
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All of these screens have been 
taken from Clipper applications. 
The difference is that four of the 


th 


Qa TER MARAE TAY 


circles, fills, bitblits and high 
level functions for 3D buttons, 


Spot the difference... 


GFORCE works with Clipper 
5.01, Summer ’87 and overlay 
linkers such as Blinker” etc. 


pull down menus, dialogs, scroll 

screens use the GFORCE bars, icons, bitmaps and fonts. 

graphical user interface. GFORCE retails for £185.00 

GFORCE provides a very fast including full documentation, 
ik in : : 


. as lor Guid Quick _libr 


Please call for a free demo disk. 
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VISUAL INTERFACE 


We led the way with dGE. This is the other 
indispensable library for Clipper. For the 
first time your Clipper programs can have 
the look and feel of a Windows application. 


Visual interface has it all.... 

Multiple windows that can be moved, sized, 

maximized and minimized 

A complete range of interactive controls 

An integrated event handler 

Simple to program 

Fully object-orientated 

Runs dGE graphics in it's windows 

Your applications will never be the 

same.... 

® Create graphical dialog boxes, data-entry 
forms and context-sensitive help screens 

® Select files from scrolling list boxes 

@ Import bit-mapped images 

® Create queries using icons, radio buttons, and 
Cee Price: £245.00 

® ~ Run several windows concurrently and move 

between them with a keystroke or mouse-click From: 


Vi comes with a 250 page manual 
including over 100 pages of tutorial with 


Bits Per Second Limited 
14 Regent Hill, Brighton, E.Sussex BN1 3ED 
Tel. 0273 727119 Fax 0273 731925 


examples. Requires: Clipper 5.01 The VI library contains elements of Class(y) and SuperClass issued under licence. You do not 
DOS 3.x or higher need to buy these products to use VI with Clipper 6.01 
640K RAM Classly) (c) Anton van Strasten 


SuperClass (c) Chydale Software 
dGE, Visual Interface (c) Bits Per Second Ltd. 
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EGA or VGA 


softwareDevelopers! 


Select « sub-mem option by using the highlight bar 
Use arrow keys (+ and *) to select options from wain mem 


. Here's the same application half an 


hour later usingTurbo C ++'s advanced 
VROOM technology... 


Naintain Nominal Codes 


Nominal Account Mo 
Description 
|| Debit / Credit Indicator 


Balance to Allocate 


Ter the Nominal Account wmber or press (F3) for a LIST 


..and here's the same application an hour 
later running under SCO UNIX, with no 
runtime licences required ! 


This entire application was developed in a couple of days 
using Sycero C. Sycero is a powerful program generator 
that dramatically reduces your programming time. Sycero 
C generates fully structured and documented C source 
code to be compiled with Microsoft or Turbo C. Sycero C 
supports the Btrieve/C-ISAM file handling systems, plus 
it can even generate C programs for use with dBASE or 
Clipper files and indexes. Sycero C UNIX allows you to 
develop software to run under SCO UNIX, and you can 
regenerate existing Sycero C DOS-based 
applications with absolutely no changes 
required to your definitions. 


|— For more information, either call us on 
0622 691616, or fill out and return the 
coupon. . 
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ABASE is a trademark of Ashton-Tate. All other trademarks acknowledged. 


Produce a sophisticated application like 
this in Microsoft C , with either BTRIEVE 
or C-ISAM, running under DOS in just a 


couple of days! 


Balance to Allocate 


GED for a LIST, (FP) — IRSERY, TW) — DELETE 
Egat a IA 


.. Another twenty minutes and it can 
access dBASE files... 


Balance to Allocate 
"Enter the Romina} Account 


“or press (Fa) fi 


Please send me further details about Sycero C 
Name: .. 


Compan: 
Address: 


Tel: Fa: 
lam also interested in your generator for Clipper, Sycero dB 
System C Ltd 60-61 High Street Maidstone Kent ME141SR 
Tel 0622 691616 Fax 0622 691241 
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An example of datagram transmission and 
reception is shown in Figures 3 and 4. Note 
that, in order for the programs to function 
properly, the Receive Datagram program 
must have issued its request before the 
transmitting program is run, A real applica- 
tion would more likely issue the datagram 
requests in no-wait mode, thus allowing 
processing to continue simultaneously with 
the transmission and reception of data- 
grams. 


As there is no guarantee of reception of a 
Datagram, there are no return codes expli- 
citly concerned with this method of trans- 
mission. 


Miscellaneous Commands 


NetBios also provides a number of services 
for the general administration of the net- 
work adapter and traffic: 


@ Reset 
@ Adapter Status 
@ Cancel 
@ Unlink 


These commands are listed in Figure 2. The 
Reset command clears the local name table 
and session table, and resets the name num- 
ber and local session number values to 2 
and 1 respectively. If the CLOSE.ON.RESET 
parameter of the NetBios driver was speci- 
fied as YES, the adapter card is closed and 


reopened. If this parameter was not set to 
YES, the adapter is not closed, leaving any 
lower-level protocol facilities running. The 
maximum number of sessions and com- 
mands are reset lo the specified values o1, 
if these are set to zero, to the default values 
depending on the state of the 
RESET.VALUES parameter. 


YUU 


Datagrams offer 
an easy method 
of communication 
across the 
network, but are 
not secure 
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The Adapter Status command returns infor- 
mation on the adapter and the error rate on 
the network. The format of the returned 
data block is shown in Figure 5, Here the 
device independence of the NetBios inter- 
face falls down, as some of the fields are 
dependent on the type of network in use. 
An additional block is returned for the 
Token Ring Adapter, and this is shown in 
Figure 6 and 7, Sufficient space in the data 
buffer must be allocated to hold the adap- 
ters local name table, which is returned in 
the format shown in Figure 8. 


f#include <dos.h> 
#include <stdio.h> 
#include <net.h> 


struct NCB Add_Name_NCB, 
char Message (50); 

char Name{16) = "Receiver"; 

char Call_Name(16) = "Transmitter"; 
uchar Local_Name_Number; 

char far *Message_Pointer; 


Receive _NCB; 


main() 
{ 


/* Initialise the two NCB stuctures */ 


/* Add the unique name "Receiver" */ 


Add_Name_NCB.NCB_Command_Code = 
NCB_ADD_NAME; 
strnepy (Add_Name_NCB.NCB_Local_Name, 
Name, strlen (Name) ); 
Net BiosCall1(&Add_Name_NCB) ; 


/* Test for success */ 


if (Add_Name_NCB.NCB_Return_Code != 0) 
{ 
printf ( "\n%02X Add Name Failed, Error\ 
Code = ", Add_Name_NCB.NCB_Return_Code) ; 
exit (1); 
} 
Local_Name_Number = 
Add_Name_NCB.NCB_Name_ 
Number; 


Code = ",Receive NCB.NCB_Return_Code) ; 


Successful\nts",Message) ; 


NCB_DELETE_NAME; 


} 


/* Receive Datagram from "Transmitter" 


to "Receiver" */ 


Receive NCB,.NCB_Command_Code 
NCB_REC! 

Receive _NCB.NCB_Name_Number 
Local_Name_Number; 


VE_DATAGRAM; 


/* Set up buffer address in NCB */ 
Message_Pointer = (char far *) &Message; 
Receive NCB.NCB Buffer Offset = 
(char *) FP_OFF (Message_Pointer); 
Receive NCB.NCB_Buffer Segment = 
(uint) FP_SEG(Message_Pointer) ; 
Receive_NCB.NCB_Buffer_Length = 50; 


strncpy (Receive_NCB.NCB_Call_Name, 
Call_Name, strlen(Call_Name)); 


NetBiosCall («Receive NCB) ; 

/* Check for fatal errors */ 

if ( Receive NCB.NCB_Return_Code != 0) 

; printf ("\n%02X Datagram failed, Error \ 
exit (1); 


} 
printf ("\nDatagram Transmission \ 


/* Delete the name added, or the next 
attempt to run the program will fail */ 
Add_Name_NCB.NCB_Command_Code = 


NetBiosCall (&Add_Name_NCB) ; 


Figure 4 - Datagram Receive Application 


NetBios 
Offset Contents 
0 Permanent node name 
6 Board jumper settings - see below 


W1 jumper on (reserved) 


W2 jumper on 
0 = Remote Program Load 
enabled 
7 Results of adapter self test 
80H Self test OK 
81H Processor test failed 
82H ROM checksum failed 
83H I.D. ROM test failed 
84H RAM test failed 
85H Host interface test failed 
86H Power test failed 
87H Digital loopback test failed 


8EH Carrier fault 

8FH Analogue loopback test failed 
8 Protocol layer major version number 
t:) Protocol layer minor version number 
10 Reporting period (minutes) 
12 CRC error count 
14 Alignment error count 
16 Collision count 
18 Transmission abort count 
Offset Contents 
20 Transmission success count 
24 Receive success count 
28 Retransmit count 
30 Resource depletion count 
32 Reserved 
40 Free NCB's 
42 Maximum number of NCB’s 
44 Adapter maximum NCB's 
46 Reserved 
50 Number of sessions pending 
52 Maximum pending sessions 
54 Adapter maximum sessions 
56 Maximum packet size 
58 Name table entry count 
60- NetBios name table 


Note: all the count fields roll over, except the 
CRC, Alignment and Retransmit counts. 


Figure 5 - 
LAN Adapter Status Block 


Offset Contents 

0 Permanent node name 

6 NetBios major version number 

7 Zero : 

8 LAN Adapter type 

9 NetBios minor version number 

10 Reporting period (minutes) 

12 Receive frame rejected count 

14 Transmit frame rejected count 

16 Information frame receive error count 
18 Transmit abort count 

20 Successful transmit frame count 

24 — Successful receive frame count 

28 Information frame transmit error count 
30 Remote request buffer depletion count 
32 Expired T1 (response timer) count 


34 Expired Ti (inactivity timer) count 

36 Pointer to extended local status block ( 
Segment:Offset) 

40 Free NCBs 

42 Maximum pending NCBs 

44 — Maximum pending commands 

46 ‘Transmit buffer depletion count 

48 Maximum datagram packet size 

50 Pending session count 

52 Maximum pending sessions 

54 Maximum sessions j 

56 Maximum session packet size 

58 Name table entry count 


Name Table 


Figure 6 - 
Token Ring Adapter Status Block 
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ve: Bios 
Offset Contents 
0 NetBios name 
16 NetBios name number 
17 Status 
_ Late: d 
Latest operational error code 
11 Return code of latest CCB command 
12 Line error count AN GoleSulede | eyelets %O: 
14 Internal error count 
16 Burst error count 
18 AC error count Bre 7 
20 Abort delimiter. count 
22 ‘Reserved 
24 Lost frame error count Name Status 
26 ~—- Receive congestion) count 
|28 Frame co| 0 = Unique Name 
30 Frequency error. count 1 = Group Name 
32 Token error count Name Status: 000 = Name in process of registration 
34- 39 Reserved 100 = Name registered 
5 101 = Name deregistered 
110 = Name detected as duplicate 
Note: Only wallater local adapters 411 = Name duplicated and pending deregistration 
Figure 7 - Token Ring Adapter Figure 8 - Status Block Name Table 


Extended Status Block 


‘Cancel’ may be used to abort a NetBios | The Unlink command is of little interest for | Derek Clifford is an independent consult- 
command by specifying the address of the | data transmission over a network, as it is | ant specialising in the use of PCs and net- 
commands NCB in the Buffer Address field. | ignored except for the case of remote pro- | works. He can be contacted on 0403 
Cancelling Send or Chain-Send commands | gram load on disk-less workstations using | 700441. 

will close the session associated with them. | the original IBM LANA adapter card. 

Name, Send Datagram, Session Status and The final part of bis NetBios series will ap- 
Unlink commands cannot be cancelled. (EXE) pear next month, 


Excellent Software Marketing is Easy. 
NOT!! 


Selling software used to take nothing more than an advert in the right magazine. 


Now it takes commitment and coordination. Commitment to pre-launch research, 
commitment to product design, commitment to support the customer through upgrades 
and relaunches. Coordination of PR, distributors, packaging design, manuals and 
translation, sales effort and a thousand other ‘little’ things. 


ISV, the newsletter for Independent Software Vendors, brings this know-how to the 
marketplace every month; 


@ News - who is marketing what and how. How will CA handle the Nantucket take-over, 
did Microsoft’s C7 launch hit the spot ? 


@ Research data - key results on customer attitudes to support, design, features and more. 
@ Opinion & Advice - from leading Advertising, PR and Direct Mail practitioners. 
@ Vertical Market Profile - marketing issues facing a specific vertical market and the 


problems and solutions of this market. 
IF YOU DEVELOP SOFTWARE, YOU MARKET SOFTWARE. 
Subscribe to ISV. £70 for 12 issues. 


Call 0442 824501 and quote your Access/Visa number. 
For further information, call 081 994 6477 xtn 2338. The Newsletter for Independent Software Vendors 
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“You only need to buy one copy! They don’t protect with DESkey.” 


DESkey — Software Protection from the 
inventors of the intelligent Dongle. 


We have more experience and expertise in the design of 
software protection modules (dongles) than any other 
company in the UK. We sell products designed in house by 
our own engineers. More than |3 years experience in the 
design of dongles have gone into our current product 
range. 


@ DESlock® automatic.EXE or.COM file encryption system. No 
need for source or.OBJ files. Takes only a few seconds to protect 
your software —now available for OS/2 and Windows. 

@ ‘Seedable’ Pseudo Random Number Generator 
Software and data encryption could not be more secure. 
@ Through Encryption, Data can be fed into the 
DESkey for on-line encryption. This keeps the 
encryption key hidden. 

@ Memory. Up to 240 bytes of memory split 
into ‘Public’ and ‘Private’ sectors. The ‘Public’ 
sector may be read from and written to at 
will. The ‘Private’ sector may be read at will, 
but writing requires your customer specific 
password, 

@ Down Counter. You program into the 


DESkey the number of times the program will run before stopping. 
This gives you the ability to sell ‘goes’ of your software rather than 
an open licence to use it forever—or even to send a fully working 
demonstration copy that will stop working after say, |0 goes. 
@ Variable Response Algorithm. This feature is similarto the well 
known ‘public-key’ algorithm and works in conjunction with an 
algorithm on the host computer. Makes any attempt at software 
emulation impossible. 
@ Secure Memory Read, Even ifthe same memory data is read 
repeatedly, the data returned from the DESkey never appears the 
same —this also makes the DESkey impossible to emulate. 
@ Parallel, Serial or Bus versions available. 

= @ Intelligent Serial devices suitable for any operating 
system such as Unix, Xenix, OS/2, DOS etc. 
Works on any hardware including PC 
Networks, Mini Systems or even 
Mainframes. 
@ Free evaluation Kits. 
@ Guaranteed Exclusivity to all our 
customers. 
@ Fast Order Tum-round. 
@ Sold only through Data Encryption 
Systems Limited. 


Edbrook House, FAST 
Cannington, Bridgwater, 

Somerset, TAS 2QE "reuse ier 
Telephone 0278 653456 : phe Data Encryption Systems 
Fax 0278 653300 Data Encryption Systems Limited isammember of FAST 
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VB Toolkit 


Visual Basic Completely 


Microsoft’s new Visual Basic Professional Toolkit provides almost eveything a developer 
would need to create a complete VB application. Or does it? Cliff Saran investigates. 


When Visual Basic (VB) was launched last 
summer, it was hailed as a major break- 
through in Windows development tools, Its 
ease-of-use and extensibility have made it 
extremely popular, and it is particularly 
suited to the rapid prototyping of Windows 
applications or for writing Windows data- 
base front-ends (although this requires a 
separate DLL to access the database). As a 
testimony to this versatility, there are now 
a growing number of third-party add-ons 
for VB. In a move to create greater interest 
in VB, and at the same time providing the 
user with greater ‘value for money’, Micro- 
soft has released the Visual Basic Profes- 
sional Tookit, which bundles together 
several Custom Controls, the Windows 3.0 
Help Compiler, the Custom Control Design 
Kit (CDK) for creating your own controls, 
and the VB Setup kit which lets you develop 
setup software. 


Pre-cooked Controls 


The Toolkit contains 21 new controls which 
can be added to the VB Toolbox using the 
Add File File menu option (see Figure 
). Let’s start with the six ‘3D’ controls 
which appear raised above a VB form, cre- 
ating the illusion of depth. There are 3D 


versions of the standard Checkbox, Com- 
mand Button (ie Push Button), Frame and 
Option Button controls (Radio Button) and 
also two new controls. The first is a 3D 
Group Push Button which can be used to 
create toolbars such as the ones found in 
Excel or Word for Windows. The second, 
called the 3D Panel, looks like the 3D Frame 
control and provides a 3D effect for text. 
Text can be made to appear raised above 
or inset within the panel. 


The Animated Button in the Toolkit has a 
set of properties which allows the developer 
to sequence any number of images. The 
Toolkit provides five ways in which an 
Animated button can display a sequence. 
The button can be made to display all the 
frames whenever the left mouse button is 
clicked, or it can display a different frame for 
each click. The control also provides a mech- 
anism for simulating a mouse click in order to 
mimic real animation. When an Animated 
Button is clicked with the right mouse button 
at design-time, a dialog box pops up which 
provides the developer with a mechanism for 
displaying and arranging the bitmaps or icons 
in the animation sequence. Each image is 
assigned a Frame Number which determines 
when it is displayed. 
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Figure 1 - New VB Controls 
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The Toolkit also provides Common Dialogs 
and Multiple Document Interface (MDD 
child windows, The Common Dialog Cus- 
tom Control provides the VB programmer 
with an interface to COMMDLG, DLL which 
comes with Windows 3.1. The control uses 
an Act ion property to select one of sev- 
eral Common Dialogs. These include the 
File Open/Save dialogs, the Change Palette 
dialog, the Choose Font dialog, the Printer 
setup dialog and Windows Help which 
causes the application to invoke WIN- 
HELP.EXE. Common Dialogs cannot be 
viewed at design-time, but pop-up when 
the Action property is set at run-time. 
With the MDI control, the developer is able 
to ‘draw’ any VB control onto the MDI child 
window which is used to produce a VB 
Control Array of MDI Windows. 


Other useful controls include the Graph 
and the Gauge, The Graph control is, in 
fact, Bit Per Second’s ChartBuilder Control 
(see .EXE Oct 91 ‘Windows Graphics With- 
out Tears’), It adds graphing and chart 
drawing capabilities to VB and supports 
several types of graph including 2D and 3D 
Pie charts and Bar graphs. The Gauge con- 
trol contains several dials and thermome- 
ters including a speedometer which bears 
a remarkable resemblance to the spee- 
dometer found in Borland setup programs. 
The gauges and thermometers are loaded 
nto the control as bitmaps. The spee- 
dometer’s needle or the reading on the 
thermometer is changed whenever the 
Value property of the control is altered. 
The Toolkit contains a number of bitmaps 
which the Gauge control directly supports. 


The remaining controls in the Toolkit pro- 
vide support for Pen Computing, Windows 
multimedia and OLE client applications (it 
isn’t possible to create an OLE Server in 
VB). There is also a Grid control for dis- 
playing tabular data and an improved Scroll 
Bar which generates an event whenever the 
scroll indicator is moved, providing constant 
feedback on its position (VB’s original Scroll 
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TABLE CUSTOMER 
END tet NOT NULL» 

VARCHARCZ0) NOT NUL» 


CuST_REP INTEGER, 
CREDTT_LIMET MONEY) ; 
PRIMARY KEY (CUST_NUM) 
FOREIGN KEY (CUST_RIPY 


CREATE INDEX custoner 
‘ON CUSTOMER (CUST_NUM) ; 


CREATE TADLE ORDERS 
ORDER INTEGER HOT NULL, 


° 


Requirements: Runs on; IBM PC-AT and compatibles, EGA/VGA color, mouse, Printers/Plotters supported: 
Epson FX & LQ, IBM Graphics & Proprinter X24, HP QuietJet, DeskJet & LaserJet II and III, HP Plotters, PostScript. 
Copyright 1992 by Evergreen CASE Tools, Inc, All Rights Reserved, All trademarks are the property of their respective companies. 
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We Just Made SQL and xBASE 
Database Development Easier! 


All of the methodology support you need for structured 
analysis, design and data modeling is now available in one 
easy to learn, easy to use, PC-based CASE tool. 


Methodologies: Diagram Types: 
Gane & Sarson Data Flow Diagrams 
 Yourdon/DeMarco (Including real-time extensions) 


 Ward-Mellor/Hatley © State Transition Diagrams 

@ SSADM (versions 3 & 4) Structure Charts 
 Yourdon/Constantine Entity Relationship Diagrams 
@ Martin Data Model Diagrams 

Chen Entity Life History 

e Bachman Logical Data Structure 


Use the dBASE II compatible data dictionary to 
support record and element definitions, control tables, 
hierarchical chart linking, and process decomposition 
to text files, Also includes an integrated data 
dictionary and reports manager. 


Analyze and verify your work. Use the analysis 
features to check the accuracy of your project and 
highlight errors. Level balance the processes, stores 
and flows on linked diagrams, Check your diagrams 
against methodology rules and verify data dictionary 
entries, including record and element definitions. 


Convert your design into a DDL (Data Definition 
Language) for use by your target DBMS to create 
database schemas in dBASE III and the following 
SQL formats: ANSI SQL, dBASE IV, ORACLE, 
DB2, Sybase, SQLServer, SQLBase, Ingres, Informix, 
OS/2 EE, and Rdb/VMS. 

A consistent “Windows-like” IBM SAA/CUA 
graphical user interface (GUI) makes it easy to 
learn and easy to use. Using the EasyCASE Plus 
Developer’s Edition is as straightforward as using any 
other application software on your PC. A sample 
project, on-line help, tutorial, methodology guide, and 
extensive documentation get you started and 
productive without expensive training classes. 


We offer full functionality at a low price: 


EasyCASE Plus Developer’s Edition ....£520 


Also available: 
EasyCASE Professional uu... £420 


(includes Analysis module only) 


EasyCASE Plus 


(does yi include Analysis or Schema 
Generation modules) 


cal ot ht your 


he 244114 
[Prior version users call for upgrade information, 


Evergreen Sole UK Distributor: 
THE SOFTWARE 
FE; CONSTRUCTION CO. LTD 
| The Maltings, Green Drift 
Tools Royston, Hertfordshire SG8 SDB 


Telephone: (0763) 244114 
Facsimile: (0763) 244025 


*Demo disk available on request. 
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ADVANCED BUSINESS GRAPHICS 


a» 
os 


Bar only generated an event when the scroll 
indicator reached its final position). 


The illustration in Figure 2 shows a VB 
application using a number of the Toolkit 
controls. To use OLE it is necessary to select 
an OLE Class (in this example ‘MS- 
Draw’) and specify the Server Proto- 
col and Server Type to be used. 
Server Protocol determines how the appli- 
cation communicates with the server - this 
is usually set to the StdFileEditing 
default. The Server Type is used to specify 
whether the OLE object is linked to the 
server application or embedded within the 
client application. To invoke the OLE serv- 
er, the control provides an Action 
property which, in this example, fires up 
MS-Paint whenever the user double-clicks 


on the bitmap within the OLE Client area 
(ie on the Leaves bitmap). 


Home-grown Controls 


As I mentioned above, the VB Professional 
Toolkit comes complete with the CDK for 
creating user-defined controls. Before you 
can start writing your own additions to the VB 
Toolbar, you'll need a copy of the Windows 


OLE Server List 
trmfile 
calfile 
erdfile 
txtfile 

\W ordArt 
Equation 
MSGraph 


WordDocument |. 


¥B Professional ToolKit rf 
OLE Client Area 


SDK. Needless to say, an understanding of 
Windows programming is a prerequisite. A 
Custom Control (.VBX file) is actually a DLL 
which can be loaded into VB. A new control 
must operate in two modes (ie at design-time 
and at run-time) and Microsoft provides the 
VBAPLLIB import library to form a link be- 
tween the user-defined control and 
VBRUN1O00.DLL (the run-time support library), 


To illustrate the concepts involved in writ- 
ing your own custom control, I shall outline 
a template control called MyControl. The 
code for this is given in Figure 3. A Toolbox 
control is associated with a number of 
properties, such as its Width and Height, 
which appear in the VB Property list-box. 
VB requires a list of these properties. Each 
property consists of an initialised PRO- 
PINFO structure. The CDK defines all the 
VB standard properties; for instance, 
PPROPINFO STD BACKCOL is the 
property which lets you change the back- 
ground colour of your control. In my 
example, the property list is called My- 
Control_Properties and consists 
of an array of pointers to PROP INFO, termi- 
nated with NULL. This list contains two 
elements - one standard property, and a 
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Figure 2 - OLE Application 
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new property called String which sets up 
a string value. 


To set up the String property it is necessary 
to create a structure to hold the string value. 
Ihave used the MyProperty structure to 
hold a handle to a null-terminated string. To 
describe my new property to VB I have 
initialised a PPROP INFO instance called 
Property String. This tells VB that 
the property is called String and contains a 
handle to a null-terminated string. The new 
property is then added to the MyCon- 
trol_Properties list. 


VB uses the Event List to determine whether 
a control should respond to a given event. 
t supports several standard events suchas Click, 
Drag and Drop ete. There is no need to write 
any code in order to supportthe clefault actions 
of standard event. In MyControl the MyCon- 
trol_Event:s list supports the Drag/Drop 
and Drag Over standard events, Each event in 
the Event List consists ofa pointerto an EVEN- 
TINFO data structures and the CDK includes 
initialised EVENT INFO data structures for all 
the standard events. It is also possible to setup 
your own event by initialising an EVENT INFO. 
structure and adding it to the Event List. A VB. 
developer can then write a VB event procedure 
which responds to the new event. 


All the features of MyControl come together 
in the MODEL structure, Once the data 
structures are in place, it is necessary to 
‘register’ the Control Model with VB. This is 
achieved by writing the VBInitCC () 
routine which VB calls whenever a new 
control is ‘drawn’ onto a form, Functionality 
is added to the control within the MyCon- 
trolProc function, pointed to by the 
pctlproc field in the MODEL structure. 
This is an event-handling routine which 
responds to the VB and Windows events 
that are posted to the control. For a more 
thorough description of how to write your 
own Custom Controls see .EXE Nov 91 ‘De- 
veloping a Visual Basic Custom Control’. 


Docs and Examples... 


The documentation that comes with the 
Toolkit is first-rate, There is one manual 
consisting of three sections. ‘I'he first is a 295 
page reference on the new VB controls with 
each one being given thorough coverage. 
Next there is a 169 page reference for the 
CDK which is based on the writing of an 
example Circle control. This starts with the 
concepts behind Custom Controls and pro- 
vides a template which can then be used to 
create your own. The example is de- 
veloped, showing how to add new features 
tothe control, Finally there are chapters that 
cover advanced topics such as sub-classing 
existing controls and providing popup dia- 
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Solutions - 
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THE 
DEVELOPMENT 
TOOL 


The heart of 

rapid application 
development is the 
development tool, and 
Enfin is the best. 
For Windows or OS/2, 
nothing comes close 
to Enfin’s power, 
flexibility and 
advanced Toolset, 
including GUI and 
Database tools. Enfin 
is fully Object- 
Oriented, so solutions 
you develop today can 
be re-used tomorrow. 
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THE CONSULTANCY 


FastStart. From the UK’s leading 
technical consultancy and training 
organisation. You need to create ever 
more complex IT Solutions in less time, 
and using all the latest technology, 
such as Client-Server, Graphical User 
Interfaces and Object-Oriented 
Programming. FastStart is your 
solution, a package comprising expert 
consultancy, specialised training and 
rapid application development using 
the acclaimed 

Enfin 

development 

tool. 


Our consultants have considerable experience in 

building GUI Clients working with powerful servers. 
FastStart consultancy will help specify, implement and 
deliver the solution, transferring their skills to your team 


in the process. £ 
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THE TRAINING 


3 QA is the leader in technical training, and QA 
will back your FastStart with a carefully chosen 
training programme. With training in the operating 
environment, in Enfin, in advanced programming 
skills, in supporting your application when it’s 


delivered, in fact whatever's required. 
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QA, Cecily Hill Castle, Cirencester, Gloucestershire, GL7 2EE, UK. TEL. (0285) 655888 
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Please send me full details of how to get 
a FastStart to developing complex client- 
server solutions for my business. 
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TELEPHONE 


Call (0285) 655888 now, or mail to 
QA, Cecily Hill Castle, Cirencester, 
Gloucestershire, GL7 2EE UK. 
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BECOME ALEADER INTHE FIELD | 
OF OBJECT ORIENTED TECHNOLOGY! 


GQ FOR [T-WITH DATAFLEX 3! 


Isn't it time you experienced the benefits 
of object-oriented programming in a 
4GL? 


You can — with DataFlex 3! 


DataFlex’s comprehensive 4GL, robust 
class libraries, object-oriented program 
generators and proven high perfor- 
mance database management system 
provide you with a complete library of 
tools for applications development. 


Generating complete object-oriented 
programs is as easy as clicking on 
AUTOCREATE in DataFlex’s menu 
system. Utilizing DataFlex’s many other 
language features lets you create fully 
customised CUA applications, 


Experience faster development, easier 
maintenance, re-usable code and better 
looking applications with DataFlex 3. 


The benefits of object-oriented 
programming are available now. Don't 
get left behind. 


Lead the field... with DataFlex! 


Call TODAY on 071-729 4460 or fax to 
071-739 1247 for complete DataFlex 
information and the name of the dealer 
nearest you. 


DataFlex Services Limited, 

DataNet House, 114/116 Curtain Road, » 
London EC2A $AH DATAFLEX 
Telephone: 071-729 4460 

Facsimile: 071-739 1247 
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// VB Toolbar bitmaps 

#define IDBMP_MYCONTROL 8000 

#define IDBMP_MYCONTROL 8001 

define IDBMP_MYCONTROL 8003 

#define IDBMP_MYCONTROL 8006 

// Macro to obtain offset into 

// user-defined property struct 

#define OFFSETIN(struc, field) \ 
((USHORT) & (((struc *)0)->£ield)) 

// Custom Control Procedure 

LONG FAR PASCAL _export 
MyControlProc(HCTL, HWND, USHORT, 

USHORT, LONG) ; 


// Property list 
// Define the consecutive indicies 
// for the properties 

fidefine IPROP_CTLNAME 0 


#define GET_STRING a2 
// User defined ‘String’ Property 
typedef struct myproperty 
{ 
HSZ StringValue; 
) MYPROPERTY; 
typedef MYPROPERTY far * PMYPROPERTY; 
PROPINFO Property String = 
( 
"String", // Name of Custom Property 
DT_HSZ, // Type = handle to 
// nuli-terminated string 
// Offset of string handle 
// in MYPROPERTY struct 
OFFSETIN (MYPROPERTY, StringValue), 


Ve 
PPROPINFO MyControl_Properties(} = 
( 

PPROPINFO_STD_CTLNAME, 


&Property String, 
NULL 
Ve 


og boxes for controls at design-time. The 
ast section of the Toolkit manual covers the 
Windows Help compiler. 


The Toolkit also contains a number of busi- 
ness clipart .WMF files, bitmaps for 
Excel/Word for Windows toolbars and the 
VB Knowledge Base which provides the VB 
developer with additional online do- 
cumentation. This features several topics 
including worked examples on using the 
CDK and articles on ‘how to do’ such things 
as performing a floodfill using the Windows 
API in VB. The limitations of VB are 
covered, together with a list of known bugs 
including details of how to recreate the bug. 
There is also a list of third-party tools which 
gives a brief description of each product 
and contact information. 


The Final Touch 


When you have finished creating your VB 
masterpiece, it is time to consider the setup 
program. The VB Toolkit provides a tem- 
plate for creating sophisticated Windows 
setups. The Setup kit consists of a Version 
Control DLL, a Setup Kit DLL, an executable 
which runs your setup script and a VB 


// Event list 

// Define the consecutive indicies 

// for the events 

#define IEVENT CLICK 0 

#define IEVENT_DRAGDROP 1 

#define 1VENY DKAGUVEK 2 

PEVENTINFO MyControl_Events{] = 

{ 
PEVENTINFO_STD_CLICK, 
PEVENTINFO_STD_DRAGDROP 
PEVENTINFO_STD_DRAGOVER, 
NULL 

Me 

// Model struct 

// Define the control model 

MODEL modelmycontrol = 

{ 
VB_VERSION, // VB version 
0, // MODEL flags 
(PCTLPROC)MyControlProc, // Control proc 
CS_VREDRAW | CS_HREDRAW, // Class style 


WS_BORDER, // Win style 
sizeof (MYCONTROL) , // Struct size 
IDBMP_MYCONTROL, // Bitmap ID 
"MyControl", // Control name 
"MyControll", // Class name 
NULL, // Parent class 
MyControl_Properties, // Prop table 
MyControl_Events // Event table 


Ve 
// Register custom control, 
// This routine is called by VB when the 
// custom control DLL is loaded for use. 
BOOL FAR PASCAL _export VBINITCC 
( 

USHORT usVersion. 

BOOL  fRuntime 


WNDCLASS class; 
HANDLE Hinst; 


// Register control (s) 
return VBRegisterModel (hmodDLL, 
&modelmycontrol) ; 
) 
// Initialize library. 
// Called from the DLL entry point in 


// LIBINIT.ASM which is called when the 
// first client loads the DLL 
BOOL FAR PASCAL LIBMAIN 
( 
HANDLE hmod, 
HANDLE segbs, 
USHORT cbHeapSize 


// Leave DS unlocked when not running 
UnlockData( 0 )+ 
return TRUE; 
} 
// Handle exit notification from Windows. 
// This routine is called by Windows when 
// the library is freed by its last client. 
VOID FAR PASCAL _export WEP 
( 
BOOL fSystemExit 
) 
{ 


) 
// MyControl Procedure 
LONG FAR PASCAL _export MyControlProc 
( 
HCTL het 1, 
HWND hwnd, 
USHORT msg, 
USHORT wp, 
LONG 1p 


// Respond to VB messages 
switch (msg) 
{ 


case VBM_SETPROPERTY : 
switch (wp) 
{ 
case GET_STRING : 


) 
return VBDefControlProc(hetl, hwnd, 
msg, wp, lp)? 


Figure 3 - Custom Control Template 


source file called SETUP.BAS which con- 
tains declarations of the setup routines that 
the programmer can access. 


The VB Setup Kit enables all application files 
to be loaded using a single API call. There is 
also a routine which creates a ProgMan 
group and icons for your application. The 
Version control DLL is used when installing 
DLLs, to check whether a more recent copy 
of a given DLL exists on the hard disk. 


Preparing a distribution disk is a cinch. First, 
itis necessary to copy VBRUN100,DLL and all 
the files required by your application onto the 
disk. Then copy the following setup kit files - 
SETUP.EXE, SETUP.LST, VER.DLL, SETUP- 
KIT.DLL and SETUP1.EXE. Finally, all DLL's 
on the distribution disk should be renamed to 
-DL_ in order to prevent them from being 
loaded unintentionally. 


Conclusion 


Of the new controls, Graph was my per- 
sonal favourite although the Animated but- 
ton and the 3D controls definitely struck a 
chord. However, I wouldn’t recommend 
that you purchase the Toolkit on the 


strength of its fancy controls, The Windows. 
3.1 controls are far more useful, providing, 
a quick-and-easy way of creating 
OLE/Multimedia applications and for using 
Standard Dialogs instead of having to 
‘draw’ File or Print dialogs for yourself. I 
welcome Microsoft's decision to include 
the CDK with the Toolkit since I believe that 
there are times when an experienced VB 
programmer would need to access the VB 
API directly, for instance within specialist 
applications or to write in-house custom 
controls. However, a budding Custom Cor 
trol developer who didn’t require Windows 
3.1 extensions would be wise to consider 
purchasing the Microsoft CDK separately 
since it only costs &39. With the Setup Kit 
and the inclusion of the Help Compiler, it 
seems that Microsoft has finally provided 
almost everything a developer would need 
to create Windows applications using VB. 
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EXE] 


The Microsoft Professional ToolKit for Vis- 
ual Basic costs £199. Registered users of 
Visual Basic can purchase the Toolkit at a 
special offer price of £79. Microsoft can be 
reached on 0734 270001. 
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Real Time 


Small Time Multi-Tasking 


In March’s .EXE, Steve Montgomery made the case for buying-in OS software 
for embedded system work. Roy Goddard takes the opposite view. 


Many computer applications - from the very 
trivial to the most complex database or 
accounts package - are essentially simple 
data-flow problems, Data flows in from a 
source (disk, keyboard, serial line) and is 
then processed before passing back out to 
another device (screen, disk, serial or 
printer port). This may be coded as a 
straightforward Initialise-read-process- 
write-close task or loop. 


However, if there is more than one source and 
one destination device, the interdependent 
use of these devices becomes difficult unless 
they are completely synchronised. This being 
the very lucky case, a simple mechanism to 
(a) understand and (b) code the problem is 
normally required. 


Such a mechanism has existed for many 
years - multi-tasking and message passing. 
The benefits of viewing a complex system 
as many tasks are considerable. The pro- 
cesses relating to particular sources and 
destinations of data may be designed and 
implemented separately, adding the inter- 
task communications and testing the whole 
later. This gives the developer the ability to 
write considerable portions of a system 
even before the final hardware or device 
driver is ready. The code may also be fac- 
tored into manageable chunks and may 
even be reused on different projects requir- 
ing similar algorithms but different data 
sources, Multi-tasking therefore has impli- 
cations on code design, implementation, 
reusability, testability and hence reliability. 


So why am [ raising the issue here, especially 
in relation to small embedded systems? 


Multi-tasking environments 


When people talk of multi-tasking, it is 
often in the same breath as Windows 3.0, 
UNIX and OS/2 2.0. When a programmer of 
embedded systems thinks of multi-tasking, 
itis often in the context of Real Time Execu- 
tives (RTXs) and operating systems such as 
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OS-9 and PDOS. As anyone fully using any 
of these systems will vouch, they are all 
resource-hungry, and add a considerable 
load to the processor(s) in the system. Is 
multi-tasking therefore out of the question 
for such a system? 


Embedded environments 


Reading the boxes for Windows 3.0 or OS/2 
2.0 will remind you that the typical system 
requirement is a 386/486 PC with 4 MB of 
RAM, 200 MB or more hard disk space and 
a VGA or better monitor. 


There are equivalent off-the-shelf operating 
systems forembedded systems. They too pro- 
vide multi-tasking, file and disk support and 
the other features of multi-tasking host oper- 
ating systems. They too are large, and may 
have considerable memory overheads, but 
they do provide a good service for appro- 
priate embedded systems, Unfortunately, if 
your washing machine, video or new car 
came with a 19" rack, power supply and 
hard disk or memory card, you would be a 
little concerned. Such applications do not 
benefit from the type of multi-tasking environ- 
ment offered by a full implementation of sys- 
tems such as OS-9 or PDOS. 


The following examples are typical small 
embedded systems, all worked on by the 
author. They illustrate some of the more 
down-to-earth requirements and con- 
straints imposed on typical embedded sys- 
tems, and illustrate why large off-the-shelf 
operating systems offer no benefits. 


The first case study involves a controller for 
a power system. This has a Motorola 
68HC11 with 64 KB total memory. All hard 
ware resources are being used by the appli- 
cation - the timer interrupts, the high-speed 
inputs and outputs and the analogue-to- 
digital converters. The CPU card was de- 
signed to a tight electronics budget as the 
overall product is cost-sensitive. All resour- 
ces of the processor are in use in the appli- 


cation, and it is the only mainstream pro- 
cessor offering the required features within 
the desired price and performance range. 
Different tasks within the overall applica- 
tion code monitor different inputs, and 
make calculations to determine output le- 
vels. Another task monitors a serial port to 
detect commands from a host PC or other 
machine. Yet another task monitors the 
front panel on the controller to determine 
and indicate direct operation of the unit. 


A second example involves an Intel 80C31 in 
a physically harsh environment. This particu- 
lar processor was chosen by the client as a 
version of it is able to survive temperatures 
outside the normal Mil. Spec. range, and its 
characteristics at the required temperature 
and pressure have been determined, There is 
therefore little choice of processor to use, and 
memory is constrained to as few devices as 
possible in order to ensure a high reliability. 
This is important, as several man-days and 
many thousands of pounds are required to 
install a new system if one should fail. Differ- 
ent tasks handle messages up and down a 
communications link, while another task car- 
ries out data acquisition. 


A third example involves a demonstration 
for a robot control language. This was orig- 
inally developed for a Z80 based CPU card 
and peripheral board, It was then required 
to port the system to a different CPU card. 
The new system used an Intel 80C196, In 
the second implementation, the parallel 
1/O required to drive the robot came from 
the on-board I/O ports of the CPU instead 
of a peripheral device. The timer used to 
control the robot movement was also 
derived from an on-board timer, rather than 
an external counter/timer chip. A timer in- 
terrupt is used to ‘step’ the robot axes. A 
keyboard task allows the user to define 
movements. Whena movement is required, 
a stepper task is activated, and either counts 
steps or waits for another keypress from the 
user to terminate the movement. This relies 
onone task enabling and disabling another. 
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Borland C++ v.3.0 £189 | C Utility Library 
C++ & Paradox Engine £199 | dBUtility Library 
C++/App. Framework £289 | FUNCky.LIB 
Turbo C++v3.0New £45 | Grumpfish Library 


Object Professional 
ProBas Prog. Library 
ProBas Toolkit 


Turbo C++ for Windows £79 
Turbo Debugger & Tools £85 


Turbo Pascal v.6.0 £65 | QuickPak Professional 
Pascal Professional £129 | Rogue Wave C++ Class Lib. 
Pascal for Windows £99 | Soft.Clip (Net. version) 
ObjectVision v.2.0 £79 | Spindrift Library 

Paradox 3.5 £325 | Spontaneous Assembly 
Paradox Engine £189 eel Sialic 
dBASE IV 1.5 £325 Soe Rania 

dBASE IV 1.5 Upgrade £90 | toois. has 

World of C++ Video £50 | Turbo Professional 


Blackstar C Function Lib 6 


Word of C++/Turbo C++ £80 


PRICES INCLUDES SHIPPING Microsoft 

= BASIC PDS 7.1 £215 

COMMUNICATIONS LIBRARI Visual Basic £90 
AdComm : C/C++ 7.0 Compiler £215 
Asyne Professional C/C++ 7.0 Upgrade £99 
ASYNCH PLUS C 6.0 & Windows SDK £315 
C ASYNCH MANAGER COBOL 4.50 £420 
C Comm Tikt Prof Ext DOS FORTRAN 5.1 £199 
C Comms Toolkit Prof. MASM 6.0 £70 
C Communications Toolkit MS-DOS 5 Upgrade £49 
Essential Communications Mulimedia Dev. Kit £215 
GET-IT Pascal Compiler £135 
Greenleaf Comm++ QuickBASIC £49 
ProBas Telocom Toolkit QuickC £49 
QuickComm QuickC/Assembler £75 
SilverClip SPCS , QuickC for Windows £90 
SilverWare C Asynch Lib. QuickPascal £49 
Solid Link with source Source Profiler £39 
DATA FILE HANDLER: Test for Windows £179 

B+ Tree Data Manager Visual Basic Toolkit £129 
B-Tree Filer Windows 3.1 £65 
B-Tree Filer (multiuser) Windows 3.1 S.D.K. £215 

BTree/ISAM multi user 

BTree/ISAM single user PRICES INCLUDE SHIPPING 


Btrieve for DOS 

C++ Database Class Lib 
C-Data Manager w/source 
C-Index/Il 


GRAPHICS LIBRARI 
3-D Computerscape/source 
3-D MiniCAD w/source 


C-ISAM ChartBuilder 

tree Plu: dGE 
bei aii r-tree EGA Toolkit 
CBTREE Essential Graphics Chart 


Essential Graphics Kernel 
Flipper 

FontWINDOW 

Geograf Prof. Ed. 
GFORCE 

GFX Font & Icon Editor 
GFX Fonts & Menus 

GFX Fonts/Menus/Graphics 
GFX Graphics 


CodeBase 4.5 

Includes free copy of Code S 
CodeBase 4.5 Upgrade 
db/LIB Database Prof Lib 
BFtrieve 

dp-MAX 

E-Tree Plus 

Essential B-Tree 

EZedit Unlimited Users 


P Grafmatic 
Faircom Server GrafPrint 
Piao Chole cnenG. 
POET P 


Graphix 

GraphPak Professional 
GSS Graphics Dev. Tikt. 
GSS*CGM Metafile Interp. 
GSS"*GKS Kernel System 
GX Developers Pak 

GX Effects 

GX Effects w/Source 

GX Graphics 

GX Graphics w/source 


QBE/Phase 1 

Toolbox Professional 

Toolbox Special Edition 

Topaz - Multi-user DBMS 

r-tree Report Generator 
GENERAL FUNCTION 

“C’erious Toolkit Plus 

3PX Extended Function Lib 

BASIC Development Tools 
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1 THE MALTINGS, GREEN DRIFT, ROYSTON, HERTS. SG8 5DB 
TELEPHONE (0763) 244114 FACSIMILE (0763) 244025 


ION COMPANY 


386 COMPILERS & EXTENDER 
86 C Code Builder ; 
86|ASM/LinkLoc 
86|DEBUG 
86|DOS-Extender Dev. Kit = 
86|VMM 

C Network Compiler/386 


GX Text 
GX Text w/Source 

Halo F/X 

Halo Image File Format 
HALO Professional 
INGRAF 

MEGAVDI 

MetaWINDOW 
MetaWINDOW/Plus 
MetaWINDOW/Premium 
NDP Plot 

PC Graphics Library 
PC-VDI 

PCX Prog TIkt w/source 
PCX Programmer's Toolkit 
PHONTM-The Fontmaker 
ProGraphx Toolbox source 
Quick Geometry Library 
QuickWINDOW/C. 

Turbo Halo 
TurboWINDOW/C 
TurboWINDOW/Pascal 
VID and DIG Graphics Lib 


Essential Graphics GUI 
Font-Tools w/source 
graphics- MENU 
graphics-MENU Pro Pak 
GSS XVT for DOS 
Object-Menu 
Object-Menu with source 
T-Windows with source 
TEGL Windows Toolkit II 
Zinc Interface Library 
COMMUNICATIONS & 
dB/LIB Network 
Net Lib 
Netware C Interface 
Network System Calls Clip 
Network Toolbox/N 


Clarion Personal Dev. 2.0 
Clarion Professional Dev. 


PALCOM Single User 


INTERSOLV AUTHORISED ee 


Professional Editor DOS or OS/2 £160 
Professional Editor DOS & OS/2 £209 
PVCS 5.0 £320 
PVCS 5.0 - 5 User £1520 
PVCS 5.0 - 10 User £2880 


Clipper 5.0 
FoxBASE+ 
FoxPro 
FoxPro/LAN 
Quicksilver 


PVCS 5.0 Upgrade £99 OBJECT-ORIENTATE! 
PVCS Config. Builder £139) smalitalk/V 
PVCS Config. Builder- 5 User £649] smalitalk/V 286 


PVCS Config. Builder - 10 User£1225 
Developer's Toolkit £CALL 
Library Gateway £CALL 


LOWEST PRICES IN U.K. 


TEXT SCREENS 
C-Worthy Library Source 
C-Worthy Upgrade to v.2.0 
C-Worthy/ewArchitect 
C-Worthy/ewArchitect/Srce 
Code Screen 
ewArchitect Source Code 


DataWindows 
HIM *REQUIRES PROOF OF PURCHASE BEFORE 


: IST FEB92. ALL PRICES + £5 Carriage + VAT 
MEWEL Window System = 


PANEL Plus II 

PANEL Plus I! Util Source 
ProGraphx Menus source 
QuickWindows Advanced 
Vermont Views + Designer 
Vermont Views GraphEx 
Vermont Views QV 
Vermont Views with source 


Smalltalk/V Windows 
PASCAL 
MetaWare Prof. Pascal x86 
Stony Brook Pascal+ 
TopSpeed Pascal - Prof. 


UPGRADE TO 


(Zortech C++ (any)* 


*All prices exclude V.A.T. 
REMEMBER WE SHIP FREE TO 
U.K. VISA or ACCESS accepted. 
Credit to approved accounts. New 
Toolbox 5.0 catalogue now 
available, call. Please check prices 
when ordering and specify disk 
size. 3.5" shipped as standard. 


Choice of multi-tasker 


Let’s look at the options available to the 
designer of embedded software. The first 
route a designer might take is to buy an 
off-the-shelf multi-tasker or RTX for his pro- 
cessor and system. This is fine in theory - 
such a system is well-written, guaranteed, 
easy to use and often has many features the 
programmer might not even have thought 
of. So what’s the problem? 


Because the off-the-shelf system will have 
been written by a company with a lot of 
different customers and target applications 
it will have too many features - washing 
machines usually don’t have disk drives 
attached! This will make it too large to fit in 
the memory space of a typical single-chip 
embedded application. If an 8031 deriva- 
tive has 8 KB of ROM on board, and 256 
bytes of RAM, there is far too little memory 
for the 256 KB of a typical full operating 
system. If it possible to strip out the redun- 
dant features, this will take a fair amount of 
time and recompilation of the OS code. This 
directly conflicts with some of the reasons 
for using a commercial system - reliability 
and ease of implementation. 


There are other problems. Often a proces- 
sor is chosen as its on-chip peripherals di- 
rectly relate to the application - this was the 
case in the first example used earlier. In 
order to cause the multi-tasker to schedule 
and switch tasks, a timer must be estab- 
lished (or some other interrupt source), If 
all are required by the application code 
then there are none free to perform this 
function. Work-arounds will inevitably 
cause the software to lose response time 
and resolution. 


Embedded systems often form a small pro- 
portion of the overall application and there- 
fore of the overall materials budget. If the 
designer can allow say &25 to &30 for the 
electronics budget (not unrealistic at 1000- 
off volumes), the additional (say) £25 for 
the license for a commercial OS can be 
prohibitive. If the overall system is price 
sensitive (such as a washing machine or 
microwave), then an additional &25 of ‘raw 
materials’ is expensive by the time the end 
user (you) has bought it from a shop. 


In the same way that a microcontroller is 
chosen because of its features, so is an OS 
or RTX. A wise designer or programmer will 
chose the OS because it is tuned to his 
processor and offers the features he wants 
and needs. If the application outgrows its 
hardware (or for any other reason) and is 
ported to a new processor, the chances are 
that the OS will at best be less efficient, and 
at worst, not exist for the new processor. 
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The designer is then either artificially con- 
strained in his choice of new processor, or 
must port the code to an entirely new OS. 


The alternative 


Given the reasons against using an off-the- 
shelf OS, is it worth the system designer 
considering multi-tasking for a project? The 


YW 
Do these large 
resource 
requirements put 
multi-tasking out 
of the question for 
small embedded 
systems? 


answer has to be ‘yes’ for the reasons given 
earlier, However, an alternative approach 
to multi-tasking should be considered. 


Most multi-taskers are pre-emptive, ie the 
multi-tasker itself decides when to time- 
slice and which task has a go next. Getting 
this time-slicing code right is the price of < 
commercial system. A simpler scheduler is 
available in the form of the co-operative or 
software-scheduled system. This is the clas- 
sic FORTH implementation, It is highly 
portable, determinate and easy to imple- 
ment by either a compiler vendor or the 
programmer himself. In fact, such a multi- 
tasker may start off as a custom system but 
then becomes ported to all applications 
written by the programmer or the com- 
pany. This has been the case with the multi- 
tasker described here - it is used in all 
targets of the cross-compiler used in the 
examples above. Such a ‘custom’ multi-tas- 
ker becomes an ‘off-the-shelf one with none 
of the drawbacks of the traditional ones. 


Each task has its own stack space and task- 
specific data, along with a slot in a task table 
for things like message data. Because each 
task voluntarily hands over control to what- 
ever task is next, the programmer is in control 
of the time-slicing priorities, and may mod- 
ify them on-the-fly. Because task switching 
is always at a known point in a specific 
procedure, the amount of processor status 
information required per-task is very small 
- usually only about two or three registers 
rather than all of them. This makes the task 


Real Time 


switch very fast and efficient. The code is 
therefore small in space, and requires little 
data space. The typical code size for a full 
message-passing prioritised multi-tasker 
with event handling is about 900 bytes. 


A typical schedule cycle involves pushing 
the selected registers onto the task’s stack 
and storing the stack pointer in the task’s 
area in the task table. It is then possible to 
increment the task number until another 
active task is found, and to restore parame- 
ters from it’s stack. The next task is now 
automatically running, and the schedule 
has taken very few machine cycles and 
instructions. Messages and events may be 
set and acted on by either assembler or high- 
level code. Because the algorithm is simple it 
is easy to implement and to debug. 


If stacks only require about 64 bytes of RAM, 
then a task may only require 70-80 bytes of 
RAM in total. It is therefore very possible to 
implement multi-tasking in single-chip appli- 
cations - with the inherent low-cost and high 
reliability of manufacture, Because the co- 
operative scheduleris simple, itis also fastand 
cheap to implement. This means that even if 
the compiler vendor has not included one in 
the run-time code the cost is not prohibitive. 


A further benefit of the co-operative sche- 
duler is that when used with an interactive 
development environment (such as the 
FORTH interpretet/compiler) tasks may be 
debugged easily and without the aid of 
In-Circuit Emulators or other hardware 
tools. This further reduces the cost and the 
time-to-market of the overall product. 


Conclusions 


Although there are many good off-the-shelf 
commercial operating systems and real-time 
executives for embedded systems, they are 
not targeted at the processors and resource 
levels of the typical small embedded system. 
Itis therefore difficult to apply a multi-tasking 
design philosophy to such applications. 
However, by implementing a small, simple 
software-scheduled system, the difficulties 
may be overcome, and the resulting multi-tas- 
ker may be used efficiently and ported be- 
tween the processors typically used for small 
embedded systems. It is therefore possible to 
apply multi-tasking design methodologies to 
small systems, especially if the compiler and 
language support the required features. 


EXE| 


Roy Goddard is a senior engineer with 
MicroProcessor Engineering Ltd, and the 
experience related uses MPE’s compilers 
and development systems. He can be con- 
tacted on 0703 631441. 


This quote comes from Steve Ashley of AT&T. 


A review of RECITAL in .EXE Magazine 


Borland CA Microsoft Recital Corporation 
dBASE | Clipper | FoxBASE RECITAL says “If you come from a dBASE background it 
Dosuanvensions!| V V would be foolhardy not to evaluate 
” 
DEC/VAX VERSIONS ao RECITAL 
UNIX VERSIONS Limited Limited Program Now said “RECITAL, the prod- 
Gros compatible sicssa -| Ent eee uct of choice for dBASE developers migrating 
to UNIX.” 
Full Referential Integrity 
are There are thousands of RECITAL users 
ik gk throughout the world. 
“True 4th Generation Recital Corporation and the Santa Cruz 
Environment 
Operation (SCO) are holding a series of 
ea a seminars to highlight the advantages of ‘for- 
ward engineering’ PC/LAN xBASE appli- 
Number of Commands* 642 346 671 1,185, cations into the Open Systems 4th 
Number of Functions* 129 141 196 37 
Generation Environments. 
* Source — Recital in Perspective To find out more: 
+ Including IBM RS 6000, HP 9000, ICL DRS, SUN SPARC 
All ‘Trademarks are the property of thier respective holder 
(1) Please send information (VI would like to see a demonstration 
QO | would like details about seminars (1 Please contact me for pricing details 
Name Telephone — 
Title Company 
Address 
Locital 
RINGSIDE, 79 High Street, BRACKNELL, Berkshire, RG12 1DZ Tel (0344) 301444 Fax (0344)300689 CORPORATION 
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VxDs 
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An Example Implementation 


David Thielen follows up his discussion of VxDs in our 
DLL Windows supplement with a working example. 


In last month’s .EXE supplement I dis- 
cussed VxDs in general terms. While I went 
on (and on, and on) about the basic princi- 
ples of VxDs and how WIN386 works, I did 
not discuss any actual code. Well, now that 
we have covered the basics, here’s the pain- 
ful detail on one specific VxD. 


Unfortunately, the best example programs 
are not themselves usable, That holds for 
the example here. While it is a useful 
example to teach you how to write a VxD, 
I strongly recommend against actually 
using it in your system. 


The following program virtualises the 
COMI port. One of the biggest problems 
with WIN386 today is the multitude of hard- 
ware cards, mostly used for communication 
of one type or another (modem, fax, net- 
work, tape, etc), that attempt to run without 
a VxD. I chose this topic in the hope that by 
focusing on this specific problem, more 
hardware vendors will provide VxDs for 
their cards. 


By concentrating exclusively on this one 
problem, I am able to fully cover a specific 


implementation. While this article shows 
you how to solve one specific problem, it 


is still useful regard 
you are writing. By 
is written, you can 


write your own VxD. 


At the same time, ¢ 
replace the VCD. It 
the COMM port and 


ess of the type of VxD 
learning how one VxD 
use this information to 


his driver will not fully 
is a VxD that virtualises 
can be used instead of 


the VCD by DOS apps. However, it does 
not include the calls required to support 
Windows COMM drivers so it cannot be 
used by Windows programs that talk to the 
Windows COMM API. 


52 .EXE Magazine, Vol 7, Issue 2, July 1992 


All of the assembler, 16 & 32-bit, was com- 
piled with the MASMS in the Windows DDK 
(NB you will need the DDK to use the code 
presented in this article). The 16-bit C code 
was compiled with MSC 7.0, Incidentally, a 
thorough understanding of UART pro- 
gramming is assumed - if you don’t have 
one, see .EXE Magazines passim. 


Let’s Get Physical 
So what are the goals of our COMM device? 
First, we need to virtualise the COMM port. 
This is not as simple as only allowing one 
program to use the port at a time. If at all 
possible, we want to allow several applica- 
tions to use the port simultaneously. Many 
applications will read the state of the port, and 
even set the communication parameters even 
if they are not going to talk over the line. 


We can fully virtualise all of the ports except 
for the actual data port. Because we cannot 
virtualise the actual data port, we have to 
make sure that only one application can talk 
on the line at any given time. If two try to talk 
at the same time, we have to let the user 
decide which application can use the port. 


We also need to reflect interrupts into the 
proper VM. This is a terribly expensive 
operation so we want to make sure we only 
do it if absolutely necessary. We accom- 
plish this by watching what value the appli- 
cation writes to the Interrupt Enable 
Register, and when we do this we also have 
to trap when the application does an EOI. 


Also, since emulation has so much over- 
head, we should define a new interface. 
This new interface is directly callable from 
DOS, Windows and other VxDs. It is de- 
signed to allow block I/O, which is much 


faster than handling things on a byte-by- 
byte basis. It also implements an open and 
close on the port, so we know when an app 
is done with it. This eliminates the need to 
handle contention problems. 


So while we emulate to support existing 
applications, at the same time we create a 
new API for new applications that works a 
lot more efficiently in a WIN386 world. If 
you write the only code that touches your 
card, then you should consider creating just 
the new interface. In this case, you still want 
to trap on your ports so that other applica- 
tions cannot write to them by mistake. 


The Code 

This article is designed to be read with the 
code, The code is well commented (at least 
by my standards) so that much of it is self 
explanatory. The rest of this article, there- 
fore, will explain the reasoning behind cer- 
tain parts of the code. 


Declare Virtual_Device sets up 
our VxD, The RS232 DEVICE_ID is an 
identification number Microsoft has assigned 
to me personally; do not use it in any of your 
own VxDs. I will use this same number for 
any other VxDs I write about. The init order 
is set to VCD_Init_Order+1 so that 
RS232 is loaded before VCD. This allows us 
to get the IRQ and ports instead of VCD. 


VidComIrq 


VidCom! rqis the data structure required by 
VPICD_Virtualise_IRQto grab the 
IRQ. ComHwInt will be called on each 
IRQ that comes in. Because we reflect the 
IRQ into a VM, we need ComEoi. Co- 
mEoi will be called when the VM does an 


Sunshow Database Professional 
Imaging Package RRP £135 


Integrate GIF, PCX, Targa, TIFF and other 
formats into your applications 


+ Scale and clip images 
“ Combine text with images using graphics 
mode SUNSAY and SUNGET 
% Functions supplied in BIN, OB) and EXE 
formats, No TSRs required 
* CGA, VGA and Hercules video modes 
+ Full printer support 
Turn your existing text based applications 
into full-featured image databases! 


Escape 

Laser Printer Library RRP £99 
Take advantage of Laserjet’s capabilities 
from within Clipper! 


* Control text position, margins, right 
justify, ete 

“ Print anywhere on a page in any order 

% Select any internal, cartridge, or soft font 
(with bold, underline, superscripts etc.) 

+ Draw lines and boxes 

* Control print orientation, paper size and 
more 

Your Clipper output never looked this good! 


Encrypt 
Security Library N/A 


When application security is as important as 
your budget, Encrypt is the way to go! 
Encrypt gives you one of the highest levels 
of security possible without special 
hardware. 

You can “encrypt” an individual DBF, DBT 
or NTX with a code of up to 8 characters 
that must be supplied by the user to access 
that record. Since each character can carry 
a value from 1 to 255, there are nearly 2E19 
(two billion trillion) possible codes - well 
out of range of random search programs. 
Since Encrypt’s routines take place record 
by record as a file is read or written, data is 
never decrypted on disk or during 
transmission. 


Fax Tools 
Fax Library N/A 


The fax is today’s fastest growing 
communication method. FAXTOOLS lets 
you send and receive faxes within your 
Clipper apps! FaxTools fully supports the 
Intel/DCA Communicating Applications 
Standard (CAS), letting you use all CAS- 
compatible fax boards. 


** Schedule faxes to send to specified 
targets at specified times 
* Check for incoming faxes 
“ Check for CAS-compliant devices on 
target machines 
“ Check the CAS log 
FaxTools is the easiest way to bring the 
speed and convenience of fax technology to 
Clipper! 
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Events Library RRP £99 

Getit, the events library and Get system 
enhancer, raises your applications’ 
awareness! With Getit, you can “trap” 
events like time intervals, keyboard 
inactivity, mouse clicks, and COM port 
activity - so you can instantly execute 
procedures in response. Using only a few 
function calls, you can flash a message 
when something arrives at a COM port or 
blank the screen when a key hasn’t been 
pressed for five minutes. For Summer ’87 
developers, Getit also comes through with 
nested reads-making saving and restoring 
GETs and READs as easy as saving and 
restoring screens! 


Pinnacle Data Conversion Utilities 
Data Transfer Package N/A 


The PDCUs were designed by Tools & 
Techniques, creators of the acclaimed Data 
Junction transfer package. 

Transfer data to and from the following 
formats: 


* dBASE (inc. Clipper & FoxPro) 
 DataEase Lotus 1-2-3 

+ R:Base *» SuperCalc 

% Q&A (read only) ASCII delimited 
With PCDUs, you don’t need the source 
and target applications on hand! 


PS Error 
Error-logging Library RRP £99 
Frustrated with getting an error message and 
not knowing what to do with it? 

PS Error helps you error-proof your apps 
before you send them out, and correct 
errors when users do run into them. 

PS Error is the only Clipper error system that 
records both rontime and fatal errors to alog 
file. You get this information from various 
internals-the stack, CPU, memory, video, 
file handles etc.- so you can quickly locate 
the source of errors. 

PS Error also lets you create your own 
messages to flash to users when errors 
occur. This helps users tell you what went 
wrong - so you can get to the bottom of the 
problem fast! 


Refererence (Clipper) 
MonthlyTechnical Journal RRP £35 


You'll get the inside word on Clipper 
development every month with a six month 
subscription to Reference CipreD 
Reference (Clipper) is a monthly reference 
journal dedicated to the needs of Clipper 
5.0 and Summer '87 developers. You'll find: 


* Application articles (with code listings) 

* Time-saving programming utilities 

“ Memory management tips 

“ News and product reviews 
Reference (Clipper) will help you develop 
faster, more powerful applications - and 
save you valuable hours in the process! 


© Copyright Four Seasons Software Ltd 1992 
All trademarks acknowledged 


SET CLIPPER Utility RRP £99 


Tired of recompiling your applications to fit 
every hardware situation - or every time you 
need a new serial number? With Sez You, 
you don't have to 


Sez You lets you burn the SET CLIPPER 
settings including the VMM system, right 
into your .EXE files. So you don't have to put 
an installation utility in every runtime copy 
you send out - and you don't need to 
compile a new version for every hardware 
scenario. 

You can also use Sez You to serialize your 
-EXE files. Each runtime copy gets a unique 
serial number in seconds! 


Borland Database RDD 
Data Driver (single user) = N/A 


Looking for a fast , reliable way to connect 
Clipper to Paradox? With the Borland 
Database RDD, you can read and write 
Paradox data files and indexes within 
Clipper! 


* Create read and write Paradox tables, 
including SKIP's, SEEK's and other 
pointer commands 

“ Create and modify Paradox table 
structures, including primary index 
fields 

* Create, select and activate primary 
indexes on Paradox tables 

* Import Paradox tables into Clipper 
arrays 

The Borland Database RDD does not 
require the Borland Paradox engine. 


TO ORDER YOUR GRAND SLAM PACK, 
COMPLETE THE ORDER FORM BELOW. 
AND RETURN IT TO: 


Four Seasons Software Ltd 
Unit 15, Twyford Business Centre 
Twyford Road, Bishops Stortford 
Herts., CM23 3YT 

England 

or fax us on +44 (0)279 758025 
But HURRY, stocks are limited. 


Name 
Address 


Town Postcode. 
Country 
Telephone. 
Fax pwede GS 
Please add shipping cost UK £10, Overseas 
£20 


| WOULD LIKE TO ORDER 


x GSPs @ £199 each £. 
a 


Shipping 
VAT (UK only) E 
TOTAL £ 


Cheque enclosed 
Debit my credit card 
Visa/Mastercard Number 


_ Expi 


CLIPPER ADD-ON SOFTWARE 


QBS Software Limited specialise in providing and supporting the best add-on libraries and utilities for Clipper 
developers throughout Europe. We stock a range of libraries, utilities and now books. We will also source 
software that is not currently on our product list. For information on products please contact our technical 
support team by phone, fax or via our bulletin board. 


We publish a quarterly news booklet, QBS Software News, which is sent free to all registered users. It is 
packed with product information, news on new releases, bug fixes and articles by renowned Clipper gurus and 


authors. 


FUNCTION LIBRARIES 
BabelFish Paradox Database Driver 


Bar Code Library Produces most bar codes. Supports 
Epson, HP, Postscript printers 
CL Text Linkable, configurable object 
orientated word-processor 
ClipWKS Read/Write Lotus/Quattro Pro 


dbXstore for Save and restore GFORCE graphics 
GFORCE screens compressed 
Dr Switch ASE Create RAM resident applications 


Fast Text Search Advanced Text Search Technology 


Flexfile Variable length fields and .DBT 
replacer 
FUNCky 1.52 Powerful Function Library with over 
400 functions 
GFORCE Fast graphical interface Library with 
Screen Editor and graphical 
Grumpfish Library Friendly Function Library 


Grumpfish Menu Smart Menu Systems 
Netlib Novel and Netbios Networking Library 
Overlay() Memory Roll Out Library 
PegLib Linkable Pegasus read/post functions 


Scripton Comprehensive PostScript Library 
available for Clipper and C 
SilverClip Professional Communications 
(Includes full source) 
SilverComm Communications Library with full 
control of serial devices 
SilverFox Communications Library for FoxPro I! 


SilverPaint Graphics Library for Clipper/FoxPro II 
SubNtx() Fast Filtering Utility 
The Engine Linkable Spell Checker 


UTILITIES 


9K for Clipper Version Control Without Tears 


Blinker The Dynamic Overlay Linker - Now multi- 
lingual 


Clipper Technical TBrowse, Get System, Principles plus 


Guides Vol. | sample disk 
Ed for Dos The Programmer's Editor 


Ed for Windows The New Windows Version 


Embark Installation and Management 
Expert Help Drop-in replacement for Norton Guides 


R & R Relational Report Writer for Clipper, 
FoxPro, dBase and Paradox 


R&R Code Generator Create programs from R & R reports 


SpellCode Jake Geller's Spell Checker 
ZipitUp Software Protection System 
CLIENT SERVER 
Biton Oracle Library 
ClipSQL SQL Server/Sybase 
ExtendBase Client Server with .DBF files 
RaSQL/B Access Btrieve files 
RaSQL/X For Novell Netware 386 
SQLBase Access Gupta SQLBase 
OOPS TECHNOLOGY 
BaseClass Clipper 5 Object Library from Chydale 
dbXstore Save SuperClass Objects 
StarClass User Interface Class(y) Library 
SuperClass II Design your own classes 


Viewlt User Interface Class Library 


All trademarks recognised 


90 days free technical support by phone or fax. 30 day money back guarantee 


For further information, free demo software, prices and how to order please contact: 


QBS Software Limited, 10 Barley Mow Passage, London W4 4PH 
Tel: +44 81-994 4842 Fax: 44 81-994 3441 BBS: +44 81-747 1979 


> CIRCLE NO, 122 


ComCallFunc dd 0 


IrqTable 


IoReadTabl dd 


IoWritTabl dd 


ComName db 
VxD_LOCKED_DATA_ENDS 
VxD_DATA_SEG 


ComApitabl dd 


NUM_COM_API EQU 
VxD_DATA_ENDS 


#RS232.ASM 
.386p 


include vmm, ine 

include debug. ine 

include vpicd. ine 
Create_N6232_Service_Table EQU 1 
include rs232.inc 

include shell.inc 


Declare_Virtual_Device RS232 
COMM_Major_ver, \ 

COMM Minor Ver, Com_Control,RS232_DEVICE_ID,\ 
VCD_Init_Order+1, Com_V86_API_Proc, \ 
Com_PM_API_Proc 

VxD_IDATA_SEG 


Used to take over IRQ 4 


VidComIrq VPICD_IRQ_Descriptor <4, 0, \ 


offset32 ComHwint, , offset32 ComEoi,\ 
, offset32 ComIret> 


VxD_IDATA_ENDS 
BUF_SIZE 
DPublic 


EQU 1024 


ComIrqHdl dd 0 ; hdl to the IRQ 
Comvm dd 0 ; VM that owns the port 
ComData dd 0 ; Offset to instance data 


call-back address 

The input buffer is composed of 3 bytes. 
For each byte in, we first read the two 
status ports so we can return the correct 
status for each data byte. It’s a circular 
buffer and if pInRead == pInWrite 

then the buffer is empty. 


piInRead dd offset32 InBuf 
pinWrite dd offset32 InBuf 
InBuf db (3 * BUF_SIZE) dup ('$! 


Same for write buffer except it’s 
only 1 byte per element. 


pOutRead dd offset32 OutBuf 
poutWrite dd offset32 OutBuf 
OutBuf db BUF_SIZE dup ('$') 


jump table for IRQs 

dd offset32 IrqModemStatus 
dd offset32 IrqTransmit 

dd offset32 IrqReceive 

dd offset32 IrqhineStatus 
Jump table for port emulation. 

We depend on the write table directly 
following the read table 


offset32 IoRead8 
dd offset32 IoRead? 
dd offset32 ToReadA 
dd offset32 IoReadB 
dd offset32 IoReadc 
dd offset32 IoReadD 
dd offset32 IoReadE 
dd offset32 IoReadPort 
offset32 IoWrit8 
dd offset32 ToWrit9 
dd offset32 LoWritPort 
dd offset32 IoWritB 
dd offset32 IoWritc 
dd offset32 LoWritPort 
dd offset32 LoWritPort 
dd offset32 LoWritPort 


serrnz ((IoWritTabl - IoReadTabl) / 4) - 8 
bInVmIrq db 0 ; re-enter count rev IRQ 
bIntEnb db 0; port 3F9h for owner VM 


For contention prompt 
"RS-232 ", 0 


Table for Com_API_Proc 

offset32 ComOpen 

dd offset32 ComClose 

dd offset32 ComRead 

dd offset32 ComWrite 

dd offset32 ComsetPort 
dd offset32 ComQueryPort 
dd offset32 ComCallBack 
(($ = Comapitabl) / 4) 


The following is locked because it is 
called at async time 


VxD_LOCKED_CODE_SEG 
BeginProc Com_Control 


Control_Dispatch Sys_Critical_Init,\ 
ComsysCritinit 
Control_Dispatch VM_Init, ComymCreate 
Control Dispatch VM_Not_Executeable, \ 
ComvmTerminate 
cle 
ret 


EndProc Com_Control 
VxD_LOCKED_CODE_ENDS 


<ComIrqldl, ComVm, ComData, ComCallFunc> 
DPublic <InBuf, OutBuf, pInRead, pInWrite> 
DPublic <pOutRead, poutWrite, Irqtable> 

DPublic <IoReadTabl, ToWritTabl, bInVmIrg> 
DPublic <bIntEnb, ComName, ComApiTabl> 
VxD_LOCKED_DATA_SEG 


VxD_ICODE_SEG 


DPublic <csc10,csc30> 
BeginProc ComSysCritInit 


+ Get instance data 

VMMCall _Allocate Device CB Area, \ 
<<aize COMM DATA>, 0> 

or eax, eax 

je csc30 

mov [ComData], eax 

; Trap all 1/0 to COM ports 

mov ecx, 8 

mov esi, OFFSET32 ComloPortTrap 


escl0: 


mov edx, ecx 

add edx, 3F7h 

VMMcall Install_I0_Handler 

je short csc30 

loopd cscl0 

7 Take over IRQ4 (we own it exclusively) 
mov edi, offset32 VidComIrg 
VxDeall VPICD_Virtualise_IRQ 

je short csc30 ; error = fail init 
mov ComIrqHdl, eax 

mov eax, 21h ; Sit on int 21 
mov esi, OFFSET32 ComInt21 
VMMcall Hook_V86_Int_Chain 

mov eax, 23h =; Sit on int 23 
mov esi, OFFSET32 ComInt23_24 
VHMcall Hook_V86_Int_Chain 

mov eax, 24h 7 Sit on int 24 
mov esi, OFFSET32 ComInt23_24 
YMMcall Hook_V86_Int_Chain 

+ Set modem control register 
mov dx, 3FCh 

in al, dx 

and al, 00001111b 

or al, 00001000b 

out dx, al 

+ Record bintEnb & then set it 


dec dx 
in al, dx 
and al, 01111111b 
out dx, al # set to not DLAB 
mov dx, 3F9h ; save Int Enable 
in al, dx 
moy bIntEnb, al 
7## or al, 0011b ; turn on xmit/rev IRQ 
mov al, 1 
out dx, al 
cle 
ret 
esc30: 
ste 
ret 


EndProc ComSysCritInit 
VxD_ICODE_ENDS 
VxD_LOCKED_CODE_SEG 


7 We come in here every time an app 
} hits one of our ports 
DPublic <ipt10, ipt20, ipt30, ipt40, \ 


BeginProc 


ipt50, ipt6o> 
ComIoPort Trap 
Emulate_Non_Byte_IO 
eld 
7 Let see if its the right VM 
cmp ebx, ComVm 
jne short ipt20 


7 We build a jmp vector using ECX & EDX. 


ipt10: 


shl ecx, 1 

add ecx, edx 

sub ecx, 3F8h 

shl ecx, 2 

jmp [IoReadTabl + ecx] 

+ If no-one owns the port - take it 


ipt20: 


cmp ComVm, 0 

jne short ipt30 

; If this VM has already written to the 
} config ports ~ we need to set it up. 
7 Set baud, int enable, line, & modem 
call SetPort 
mov ComVm, ebx 
jmp short ipt10 
; If this is anything except 3F8 
¢ - we fake it 


¢ Take it 


ipt30: 


cmp dx, 3F8h 

jne short ipt10 

; If it’s the Low Baud rate we do it 
mov eax, ebx 

add eax, ComData 

test (eax.bLine], 10000000b 

jnz short ipt60 

; If we have failed the app once 

; = we fail again 


Figure 1 - Part 1 of RS232.ASM 


Ny 


VxDs 


EOI. At that time, we then do a 
VPICD_Phys_ EOI. 


Finally, when we are reflecting interrupts to 
a VM, we want to be careful not to use up all 
of their stack. Therefore, rather than simulat- 
ing another IRQ when the VM does an EOI, 
we wait until their IRQ handler does an 
iret, completely freeing its stack, before 
we send another one in. We use ComI ret 
which is called after the VM does an iret 
to emulate the next pending IRQ. 


The VPICD is the program that actually 
gets the IRQs. When it receives an inter- 
rupt, it will mask the interrupt off and then 
send an EOL It then reflects the IRQ to our 
VxD. When we do a VPICD_Phy_ EOI, 
the VPICD will then unmask the interrupt. 
This has two important ramifications. First, 
another interrupt can then occur immedi- 
ately and we will see it as soon as we 
unmask it. Second, if we never EOI, then 
the interrupt will never be unmasked and 
we will never see it again. 


Buffers and data 


When a byte comes in on the data port, we 
want to read it before the next data byte 
overwrites it, AVM cannot always respond 
this quickly, While on average we must be 
able to reflect data to the VM as fast as it is 
coming in, we can’t do it on every byte. 
This is akin to the argument on polling 
versus using an interrupt to handle an 
asynchronous line. 


Therefore all reads and writes are done 
within the VxD using buffers. All port 
emulation read/writes also go to the buf- 
fers. Both the read and write buffers are 
circular buffers, If the read and write 
pointers point to the same location, then 
the buffer is empty. There is no check to 
see if we are going to overrun the buffers 
because if we checked, we would have 
the option of losing old or new data. By 
ignoring the problem, we lose old data, 
The result is the same - the program still 
runs but data is lost. 


The read buffer requires the use of three 
bytes for each data byte received. For 
each data byte, we first read the two 
status registers and store them. We then 
read the data byte and store it. We read 
the status bytes first so the line status will 
show we have a data byte. By saving all 
three bytes, the calling application can get 
the status for each data byte. 


Next comes a number of jump tables. These 
are used at various places within the code 
to jump quickly to the proper function. 
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VxDs 
test | [eax.cdFlags], COMM_FL_FAILED mov pInRead, esi biInVmIrq is a count of times we have 
jnz short. ipt5o sti 
SAE lh eae ee aoy Tees cleo sent an IRQ to the VM that have not yet 
; - fail the call ret ; No wrap ~ return it returned. There is no problem with sending 
mov eax, ComVm ir810: ; Wrap ptr " y 
add eax, ComData mov pInRead, offset32 InBuf several at once, as long as we don’t over- 
test —_ [eax.cdF lags], COMM _FL_OPENED sti flow the VM's stack. This count is used in 
TRAPN2 mov [ebp].Client_AL, al - 
jnz short ipts0 ret such a way that it should never go over 2. 
+ We need to ask who gets it ir820: 
shad xor al, al ; Nothing to read 
Roy loss COavi sti bIntEnb holds the value of the Interrupt 
mov esi, offset32 ComName mov [ebp].Client_AL, al CF 
VxDcall SHELL_Resolve_Contention ret Enable Register as set by the VM that owns 
je short ipt40 ; Not resolved ~ fail EndProc ToRead8 the port. Regardless of what value is set, the 
emp ebx, Comm 2 
Se short spe40: 7 No change’= fail Deere aeaae hardware always has bits 0011b set. How- 
ie age switching to the new VM Mescauinittle che cveveheEioonake ever, if the app in the VM has not set these 
mov eax, ComVm ; Set old one to failed Se apse bits, we do not want the performance hit of 
dd ComDat. ; 
or (eax.cdPlags), COMM_FL,FATLED } Gee if DIAB io oct. If not, we fake emulating an IRQ. Therefore we use the 
mov ComVm, ebx 7 Set to new VM p Ghe EEN Byte. ‘Sanpe we inees: TE bOn values in bIntEnb to see if we need to 
call _ SetPort ine dx refl 
jmp ipt10 ; Changed - do it inc Ge ° reflect an IRQ. 

; Leave it to the existing VM ues a5 00000008. 
‘pbaos jnz short ir910  ; setting baud rate 
popad 


ok mov al, bIntEnb ; get set Int Enable ComSysCritInit 


add eax, ComData mov [ebp].Client_AL, al 


or (eax.cdFlags], COMM FL FAILED eee We do all of our initialisation during 
1, al ir 3 lec dx 
aoe" [abpiceivene’aty, ai dec dx Sys_Critical_Init. Thisallowsus to 
ROG AGRecuEN noehing Snails Tex et on the IRQ and ports while no interrupts 
} This VM was already told no mov [ebp].Client_AL, al 8 Q P P' 
ipt50: ret are occurring. We first use Allo- 
xor al, al ir920: ; We are faking it 
mov (ebp).Client_AL, al Gov, edi be cate Device_CB Area to get some 
ret ; Return nothing add edx, Combata eat per VM data, We can then access this data by 
} Ok - this is a R/W to 3F8h for the Low test (edx.bLine}, 1 }00b 
reenUD Kyte Tie eee we Ol4eeie Bead jnz short 11930 adding the returned value to the VM handle. 
ee aed Moy. [ebp]ieluent A, a2 ; 
BAe aRSee, {p90 | eG. e Msibe ret Next we take over the eight COM1 1/O 
mov dl, [eax.bLowBaud) ; It’s a read ix930: C “ . 
mov (ebp).Client_AL, dl mov al, (edx.bHiBaud) ports. If we cannottake overall of them, we 
ret mov (ebp}.Client_AL, al then return with carry set which will tell 
ipt90: ret i : 
moval, [ebp).Client_ab ieee WIN386 not to load our VxD. If we don’t 
mens DuCMBENG ie DPublic <iral0> own all of the ports, we are in conflict with 
mnabvos. iconrororkniap pag core ee tern another VxD (this is why VCD will fail to 
} If this VM has already written to the mov esi, pInRead load if you load this VxD). 
} config ports - we need to set it up. cmp esi, pInWrite 
+ Set baud, int enable, line, & modem je short irald 7 Nothing left 
eed ae ; If we have data - return 100b Following that, we take over IRQ4. Ina com- 
mov ecx, ebx UACenet eae eecuen Oo mercial VxD, both the port numbers and IRQ 
Eaters mov (ebp] Client Aly a should be able to be overridden by values in 
‘ aL 
mov al, [ecx.bLine] lease SYSTEM.INI. You can read SYSTEM. INI using 
or al, 10000000b BOATS 
out dx, al 7 ‘Turn DLAB on ae a  oenetets ei Get Profile String. This allows 
mov..dx; Fh Be ee you to change settings if the board is recon- 
mov al, [ecx.bLowBaud] 
out dx, al EndProo., ToReadA figured. Once we have both the ports and 
ine:o% Pee pase IRQ, we know we can run 
mov al, (ecx.bHiBaud) BeginProc IoReadB » Wi an a 
out dx, al } See if its the one that owns it 
dx, 3FBh cmp ebx, ComVm nee 
Royale BLine) jne short irb10 Next, we hook interrupts 21h, 23h, and 24h. 
and al, 01111111b in al, dx We do this so we can take ownership of the 
out dx, al # Turn DLAB off mov (ebp].Client_AL, al port away from aVM if it terminates While 
mov dx, 3F9h ret bs 
moval lecx.neae] irb10: interrupts 23h and 24h do not guarantee 
7## or al, 0011b mov edx, ebx A 
out dx, al; Set IRQ enable add edx, Combata that an app has terminated, an app can 
mov dx, 3FBh mov al, [edx.bLine] . . : - 
Ee eee ote] Pov Tespliciiene Aly an terminate in this manner. 
out dx, al + Set line control ret 
ine dx EndProc IoReadB 7 PPT “i “ 
Bat seagiilodeal BeELie eincies Finally, we initialise the COM hardware to 
out dx, al 7 Sct modem control BeginProc ToReadc have interrupts on and enabling the trans- 
popad ; See if its the one that owns it mit and receive interrupts. 
ret cmp ebx, ComVm 
EndProc SetPort jne short ircl0 
DPublic <ir810,ir820> in al, dx 7 ‘ 
BeginProc ToReads mov (ebp].Client_AL, al Port Trapping 
; Do we have any receive bytes? ret 
ou sige This is where half the work of emulating the 
mov esi, pInRead mov edx, ebx ‘ 
comp esi, pinlrite ada Coma port occurs (the other half is the IRQ emula- 
je short ir820 } Nothing left mov al, [edx.bModem] . 7 
; Return data byte, inc buffer pointer mov [ebp].Client_AL, al tion). ComloPortTrap is the common 
inc esi cee entry point. If the call comes from the VM 
inc esi EndProc IoReadC h: h af h rf aes + . 1 
lodsb Public <irdl0, ird20> that owns the port, the logic is quite simple. 
emp esi, offset32 InBuf + (3 * BUF_SIZE) BeginProc IoReadD 
jae short ir810 7; We wrapped 
|x Firstwe callEmulate_Non_Byte_I0.If 
P ; we get a request for non-byte I/O (word, 
Figure 1 - Part 1 of RS232.ASM (Continued) Leena i 


dword, string) this macro will break it into 
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... Isn't as good as the rest 


Nobody gets it right first time. 

Sometimes you do, but then throw it all 
away by making so many of those "subtle" little 
changes, you end up stuck with something that 
looks nothing at all like how you wanted it to. 

Still, that's life. Or at least that's life before 
MKS RCS - the Revision Control System that 
keeps a complete history of all the changes 
made to yourfiles. Itlets you retrieve any, orall, 
of them without any fuss. You can retrieve them 


by date, by release number, or by whatever 
name you had previously given them. 

Binary or text files? They're handled by 
MKS RCS with the same contemptuous ease. 

Multi-users? No problem. Alocking feature 
prevents more than one person from ringing 
the changes at any given time. 

Branching? Youcan have as many parallel 
branches as you like, meaning you really will 
be able to see the wood for the trees. 


i, 
a 


Other features? File-compression; a new 
menu interface; conversion facility from SCCS 
files; compatible with UNIX system RCS. 

Change away to your heart's content. If 
you did get it right first time (or the second, or 
the third, or the fourth...), you can go back to 
it at any time you like. 

But there's one change you'll want to make 
permanent. And that's the change to MKS 
RCS. Call 0763 244144 for details. 


Compatibility: MKS RCS is available for DOS, OS/2, XENIX and 386/UNIX. 


For an MKS brochure contact the sole UK distributor: 


The Software Construction CompanyLtd, 1 The Maltings, Green Drift, Royston, Hertfordshire SG8 SDB: Telephone: 0763 244114. Fax 0763 244025 
MKS RCS, leader in performance AND price: DOS version £165 (5-user licence £645); OS/2 version £225; DOS & OS/2 version £259, 


RCS wWhenachange.. MO 


)n| 


@ 
programming 


editor for 
Windows 


@ Full Windows 
implementation 

Cut & Paste, nearly infinite Undo, 
Point and Click or key strokes control 
all features 


@ Multiple files and 
windows using MDI 

Load and view several files 
simultaneously in separate windows 


@ Folding text 

Manage large object modules with 
sections of text ‘folded’ up into a 
single line 


@ Code documentation 
Add ‘post-it’ style notes to any file 


@ Fully reconfigurable 
keyboard and menus 
Re-assign all keys and menus, make 
multiple key assignments 

@ Powerful macro 
language built-in 

Create and compile macros using 


any editor function with a Basic-like 
language 


@ £95 + VAT 


positive 


edit insert macro utilities options window 


samp! e.h { sample.c 
/* sarnple.h "? 


define IDM_ABOUT 100 li} 


llong FAR leeds WindFn(HWND WORD,WORD,DWORD); 
ROO! tnif\wien 
a FAR PASCAL WnrdFn(HWND hWnd WORD message WORD wParam,D'WORD dwParam) 


FARPROC |pProcAbout; for oa 


switch{message) { 
case WM_COMMAND: 


case WM_DESTROY: [fl 
PostQuitMessage(0); 
break; 


case WM_MOUSEMOVE: fi | 


default: 
return{DefWindowProc{hWnd message, wParam,dwParam)); 


} 
return(NULL); 


Te \work\sample\sample.c 


+s [00005017 


s more and more users switch to Windows 3, the 
Avexrere for Windows software continues to grow. Yet 

much of the developer's toolkit still runs under DOS. 
Writing for Windows has always been more complex than for 
DOS, and project management can be especially tricky as 
Windows programs tend to be made up of large numbers of 
files. 


ix was developed to enhance programmer productivity. ix 
runs under Windows, and uses all the standard GUI features — 
MDI, split windows, cut & paste, choice of fonts and colours. It 
also contains several unique features which allow the developer 
far greater control. 


With ix you can edit and test within Windows — no more 
switching in and out of a DOS editor. Compilation/make files 
can be launched from a ‘Browse’ window. 


Browse windows help you keep track of the multiple files of 
a Windows project. A browser can be created for each project 
and used to fire up edit windows, launch resource editors (such 
as SDKpaint) and run programs as in Program Manager. 


‘Post-it’ style notes can be stuck onto any source file — 
without modifying the file. Their names can be used to give a 
hypertext-like help system throughout your project. 


And there's more; our AdHoc macro language, reassignable 
keys, custom menus and free telephone support, but we 
haven't got space to tell you about all that here. For more 
information, call or write us and we'll send you our information 
pack. 


° positive limited ¢ 
e 22 westminster buildings ¢ 
e new york street 
e leeds Is2 7dt 
e 0532 343 104 e 


Microsoft is a trademark and Windows is a trademark of the Microsoft Corporation. Positive Limited reserves the right to change the 
specification of ix without notice. 


> CIRCLE NO. 124 


byte sized calls. Since I don’t foresee anyone 
actually using these calls, Luse the slow emulate 
macro. On the other hand, if it would be com- 
mon foran app to read ina 512 byte string, you 
want to handle it yourself. 


Next, we clear the direction flag (do this - 
otherwise you too will spend six hours trying 
to find the intermittent bug in this program). 


Then, if we don’t take the jmp, we build 
the jmp vector offset. This takes into ac- 
count the sizes of the read and write tables 
as well as the specific values of ECX for 
reads and writes. We then jmp to the 
proper function, so the ret from that func- 
tion will take us directly back to WIN386. 
Any call, jmp, or ret flushes the on- 
board cache on the 386 and 486, so we want 
to minimise these. Conditional -jmps that 
are not taken do not flush the cache. That’s 
why ComIoPort Trap hasa single jmp 
‘or the common code path. This approach 
is used throughout this code. Remember, 
emulation code is never fast enough. 


f the calling VM doesn’t own the port, we 
need to decide what to do. If no one owns 
the port, then it is assigned to the calling 
VM. It would probably be better to assign it 
to the first VM that accessed the data port, 
but we assign it to the first app to hit the 
port at all. We then initialise the port to the 
values we were holding in our instance 
data. If the app has written those values 
(while another app owned the port), it ex- 
pects the hardware to be in a certain con- 
figuration. 


fsomeone else owns the port, then we fake 
it if it's not a data read/write. We fake it by 
reflecting it back to the port-specific func- 
tion which will handle this. The one excep- 
tion is I/O to 3F8h when it is set to be the 
baud rate instead of the data port. That is 
handled in-line. 


f we have a data I/O and someone else 
owns the port, we then have to decide who 
gets it. If the owner app used the new API, 
they keep the port. This not only gives apps 
an incentive to use the new API, but it 
leaves it with the app that will free up its 
use as soon as it is done. 


Otherwise, we put up a contention Message- 
Box using SHELL_Resolve_Conten- 
tion, This call will very nicely put up a box 
asking the user to pick between the two 
VMs using their window titles to ID them 
(which usually both read ‘MS-DOS 
Prompt’). If the user picks the new one, the 
ownership is switched. The one that is not 
picked is marked as FAILED so we don’t 
eep prompting every time it tries to 
read/write a byte. 


IoRead 


In IoRead8, all input goes through the 
buffer, so the first thing we do is see if there 
are any bytes in the buffer. If not, we return 
a0 since the data port is empty. If there is 
data, we get the data byte from the buffer, 
inc the read pointer to the next set of data 
and return the byte. Notice that we only 
take a conditional jmp if the pointer 
wrapped, This eliminates jmps from the 
common code path. We only get to Io- 
Read if it the DLAB bit is off (it’s the data 
byte). ComIoPort Trap handles virtua 
ising the low byte baud rate in 3F8h. 


ToReadq9@ is doubly tricky. If the DLAB bit 
is set in register 3FBh, then register 9 is the 


high byte of the baud rate. If it is not set, 
then it is the bitmap of the interrupts we 
have enabled. If it’s the interrupts, then we 
have to make sure we return the values the 
app set, which may be different from the 
actual values, since we force the transmit 
and receive interrupts on. 


Our first test is to see if we own the port. If 
not, we jmp to the end of the function to 
return the information from our instance 
data. On a write to 3F9h (below), we save 
these values so we are returning what the 
app expects. If DLAB is set, we read the port 
and return the value. If DLAB is not set, we 
return the value in b Int Enb so the app is 
receiving the value it set in the interrupt 
enable register. 


; See if its the one that owns it 
cmp ebx, ComVm 
jne short ird20 
; Do we have any receive bytes? 
mov esi, pInRead 
cmp esi, pInWrite 
je short irdio 
‘TRAP 
lodsb 
mov (ebp].Client_AL, al 
ret 

irdl0: 
in al, dx 
mov [ebp].Client_AL, al 
ret 
; Let the app know that we can’t read or 
; write & everything is errored 

ird20: 
mov al, 00011110b 
mov (ebp].Client_AL, al 
ret i” 


Nothing left 


EndProc IoReadD 
DPublic <ire10> 
BeginProc ToReadE 
+ Do we have any receive bytes? 
mov esi, pInRead 
cmp esi, pInWrite 
je short ire10 
mov al, [esi + 1) 
mov [ebp}.Client_AL, al 
ret 


i Nothing left 


irel0: 
in al, dx 
mov [ebp].Client_AL, al 


ret 
EndProc TIoReadE 
BeginProc ToReadPort 


in al, dx 
mov [ebp].Client_AL, al 
ret 
EndProc IoReadPort 
DPublic <iwx10, iwx20, iwx30> 
BeginProc IoWrité 
; If there are no pending writes - and 
; buffer is empty - write it 
mov edi, pOutWrite 
cmp edi, pOutRead 
pushfd 
iwx10: 
stosb ; Store the data 
cmp edi, offset32 OutBuf + BUF_SIZE 
TRAPae 
jae short iwx30 
iwx20: 
mov pOutWrite, edi 


} We rolled 


i Save new ptr 
; if no pending writes - write it 
popfd 
je IrqTransmit 
TRAP 
ret 
; Do this so that we usually don’t jmp 
; This is a lot more efficient 

iwx30+ 
mov edi, offset32 OutBuf 
jmp short iwx20 

EndProc IoWrit8 

DPublic <iw910,iw920, iw930> 

BeginProc TIoWrit9 


; Will send the byte 


+ See if its the one that owns it 

cmp ebx, ComVm 

jne short iw920 

7 See if DLAB is set 

ine dx 

ine dx 

in al, dx 

test al, 10000000b 

7 In case DLAB setting baud rate 

mov al, [ebp).Client_AL 

jnz short iw910 

mov bIntEnb, al 
7## or al, 0011b 
iw910: 

dec dx 

dec dx 

out dx, al 

ret 


+ force xmit/rev on 


; We are faking it 
iw920: 

mov edx, ebx 

add edx, ComData 

test — [edx.bLine}, 10000000b 

jnz ir930 

mov al, (ebp}.Client_AL 

mov [edx.bIir], al 


mov al, {ebp].Client_AL 
mov (edx,bHiBaud), al 
ret 
EndProc TIoWrit9 
DPublic <iwb10> 
BeginProc LIoWritB 
; See if its the one that owns it 
cmp ebx, Comvm 
jne short iwb10 
mov al, (ebp].Client_AL 
out dx, al 
ret 
iwb10: 
mov edx, ebx 
add edx, Combata 
mov al, (ebp].Client_AL 
mov (edx.bLine}, al 
ret 
EndProc IoWritB 
DPublic <iwcl0> 
BeginProc IoWritc 
; See if its the one that owns it 
cmp ebx, ComVm 
jne short iwcl0 
mov al, [ebp].Client_AL 
out dx, al 
ret 
iwel0: 
mov edx, ebx 
add edx, Combata 
mov al, (ebp].Client_AL 
mov [edx.bModem], al 
ret 
EndProc IoWritC 
BeginProc IoWritPort 
mov al, [ebp].Client_AL 
out dx, al 
ret 


EndProc IoWritPort 


Figure 1 - Part 1 of RS232.ASM (Continued) 
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ToReadaA is completely faked. We know 
what IRQ we sent down to the app and 
return the appropriate value. If we did not 
send an IRQ down, we either return 001b 
(receive IRQ) if we have data, or nothing if 
we don’t. 


ToReadB and IoReadC are both quite 
simple. If it’s the app that owns the port, we 
read from the hardware. If not, we read 
from the instance data. 


ToReadb returns the line status. It tells us 
if we can read or write a byte and if there 
are any errors. If the calling app owns the 
port, we return data from the read buffer. If 
the read buffer is empty, we read the actual 
port. However, if the calling app does not 
own the port, we return 00011110b which 
tells the app that the transmit buffer is full 
(the app can’t write), the receive buffer is 
empty (the app can’t read), and all error bits 
are on. I figure this is the best way to get the 
point across to the app that it isn’t going to 
have any luck with this port. 


ToReadB is straightforward. If the calling 
app doesn’t own the port, we use our in- 
stance data. If it does own the port, we get 
the data from the read buffer. If the read 
buffer is empty, we read from the hardware. 


ToReadPort (used only for port F) just 
reads from the hardware if the calling app 
owns the port. If the caller does not own 
the port, it returns 0. This port is undefined 
for the 8250 so we can’t virtualise it. 


IoWrite 


ToWrit8 copies the data to the write buff- 
er and increments its pointer, Again, it uses 
two jmps if the pointer wrapped, to avoid 
-jmps when the pointer doesn’t wrap. Then, 
if the output buffer was empty, we call 
IrqTransmit to send the byte to the 
hardware. 


ToWrit9, like ToRead, is tricky. If the 
write is from an app that doesn’t own the port, 
we copy the value to the instance data for that 
VM. We do this for both the interrupt enable 
and high baud registers (both of which use 
this port). We use the instance data for the line 
control register to determine if DLAB is set. 


If the app owns the port, and itis writing to 
the interrupt enable register, we save the 
value in bIntEnb and then or it with 
0011b. This forces an IRQ on receive empty 
and transmit full which we need for our 
buffering code. We then write the byte to 
the hardware. 


THE INSTITUTION OF 
ANALYSTS & P 


Founded some 20 years ago, the Institution is 
Britain's leading specialised professional body for 
systems analysts and computer programmers. 


The Institution's primary aim is to promote 
vocational skills and professionalism. It also seeks 
to support members in a number of practical ways. 
Members are entitled to use the Institution's 
designatory letters as a mark of professional status. 


Applications are welcomed from all men and women 
engaged in systems analysis or programming, and 


from those training for the profession. 
* 


Telephone 
081-567 2118 


The Institution of Analysts & Programmers 
Charles House, 36 Culmington Road 
London W13 9NH, England 
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081-567 4379 


Fax 


The Language: multiple 
assertions, siscipling 
polymorphism & dynam 
typing, deferred classes..,/) \ 


The Libraries: data struct 


opportunity to produge qualityreus 
are using Eiffel fortheir developmen 
Telecom Austtali; 5 Motorola, 8 
GEC-Marconi Research... Join them. 


VxDs 


IoWritB and IoWritC are both quite 
simple. If the calling app doesn’t own the 
port, we copy the value to the instance data 
for that VM. If the app does own the port, 
we write to the hardware. 


ToWritPort (used for ports A, D, E, & F) 
goes directly to the port if the calling app 
owns the port. Writing to these ports is un- 
defined for the 8250 so we can’t virtualise it. 


To be continued. 


David Thielen is a Senior Software Design 
Engineer in the DOS/Windows Business Unit, 
presently working on an unannounced pro- 
duct. Prior to joining Microsoft, he was Direc- 
tor of Software Development at Harris & 
Paulson in Denver. 


The opinions expressed in this article are 
those of the author and not necessarily (in 
some cases definitely no) those of Microsoft. 


The complete code to David’s program is 
available on disk. Please send us your disk 
(obeying exactly the instructions given on 
Page 1, Column 1, otherwise you may for- 
Jeit iD, marking envelopes ‘VXD’. 


EIFFEL: The Key to Software Quality 


The Eiffel System: A unique combination of advanced 
object-oriented techniqu¢s) 
Software Engineer. 


for the quality-minded 
i 

i N . fi i. 
\inheritance, genericity, 
‘ i ; 
exception handling, 


’\ binding, strong static 


4 


The Environment: automatic compiler, source level 
debugger, automatic doc 
design tools, garbage caflectioh... 


entation tools, graphical 


Lures, parsing & lexical 
K 


analysis, persistency, X-Windows, character windows, 
interfacing tools... : 


\ 
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Hundreds of companies worldwide have grasped the 


usable software, and 
ies - Philips, 


it 
cker Siddeley, 


For further information contact: 
Applied Logic, 9 Princeton Court, 

55 Felsham Road, London SW15 1AZ; 
Tel 081 780 1088, Fax 081 780 1941 


Applied Logic 
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SOFTWARE 71 (0. 


! Over 15,000 Software 
‘Products for 


If you find an identical software 
| product advertised in the national 
| (| computer press by another mail-order 
ie}! company based in the U.K at a legiti- 
H mate, current price - tell us at the time 
F 
H 


| fe |_reFonmm 


of placing your order and we will 
happily BEAT that price and SAVE YOU 


aSV2VIVG 


MONEY! Join the 1000's of customers 
1/2 who have already benefited! 


The Widest ‘Selection of Applications and Bevemorent Tools Anywhere 
Don’t forget - We’ll BEAT Any Nationally Advertised Price! * 


WHAT MAKES US DIFFERENT 


FREEPHONE 0800-378-873 Orders Only 
FREEPOST Mailing Address 

24-Hour FAX Orderlines 

Up to 50% Discount/15,000 Titles 

FREE Post-Sales Technical Support 
Bulletin Board 0222 865551 (2400,8,N,1) 
Compuserve Mailbox 100015, 3570 


Unbeatable Prices * 

FREE Literature Department 

Friendly & Knowledgeable Sales Staff 

VISA, ACCESS & Mastercard Accepted 

Over 6 Years Experience Providing the 
Very Best in U.K and U.S Software 

Stable & Secure Company since 1986 


MORE SOFTWARE THAN ANYONE ELSE! 


Call 0222 887521 eFax 0222 862209 


Products shown in this advertisement represent only a small sample of our full range. 
Please specify Media Size when ordering. All our prices exclude Carriage & VAT. 
All Trademarks & Registered Trademarks are hereby acknowledged 
© Copyright '91/92 Software Paradise. All Rights Reserved. 

Software Paradise, Avenue House, King Edward Avenue, Caerphilly, Mid Glamorgan, CF8 IHE 


: TEL FAX 
Mail to: Software Paradise, FREEPOST, Caerphilly CF8 1ZZ 


Pick up the phone and say hello to the convenient way to buy ALL your PC 
software. Software Paradise Expressline is the fast, new distribution 
system for all of today’s popular titles. Choose from the widest range of 
software available from any single source, all listed in our FREE 100-page 
Buyers’ Guide. 


Software Paradise has supplied 100,000's of customers since 1986 and has 
fast become the U.K’s leading software supplier. Our service is both 
convenient and affordable with up to 50% off manufacturers RRP’s and the 
widest range anywhere! 


FREEPOST -TODAY no stamp NEEDED 


] Please rush me my FREE copy of 

I ‘The Discerning Persons Guide to Software’ 
NAME 

] COMPANY 

| ADDRESS. 
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The ‘Thanks for Nothing’ 


Awards 


Jules reveals the winners of the industry's least prestigious awards. 


The ‘Thanks for Nothing’ awards are given to 
companies which, in their own way, make 
peoples lives more difficult as a result of their 
negligence or stupidity, Itis my way of saying 
to them ‘You expect me to put that on my 
disk?’ This year, I've decided to give the awards 
to demonstrations of software products. 


Demonstrations are very strange products - it 
seems the more the real software costs the 
poorer the demonstration, Shareware pro- 
grams, some of which are very good indeed, 
almost universally have superb demonstra- 
tions, yet programs costing hundreds or thou- 
sands of pounds have demonstrations which 
don’t work, or don’t demonstrate the soft- 
ware, or have functions removed which 
makes the demonstration far from repre- 
sentative of the product. The worst of all are 
slide shows - all these say is that the pro- 
grammers are feeling terribly smug about 
their pretty screen layouts; they tell you noth- 
ing about the actual product. 


For a while I was unsure about making the 
awards to demonstrations. After all, a dem- 
onstration is a favour extended to the user 
by the publisher, and to criticise these fa- 
vours seemed churlish. Eventually I de- 
cided that, far from being a favour, 
demonstrations represent a form of adver- 
tising. Indeed, they are very powerful as 
advertising, since once a user has a copy of 
a program in his hands and starts using it, 
he will be reluctant to stop using it if he 
finds it sufficiently useful to reach the limits 
of the demo. A company can spend hun- 
dreds of thousands of pounds on press 
advertising, and still not achieve the appro- 
val and awareness of a product that a really 
good demo will. 


Nevertheless, many companies seem to 
throw their demonstrations together. Few 
can spend as much on the software that 


even a single advert for the demo will cost.. 
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I suppose that a company with some star 
programmers and some kiddie programmers 
(and what company hasn't?) will tend to set 
its stars writing the product and set its kid- 
dies writing the demonstration. This is 
crazy - it costs not much less to distribute 
demonstrations than to distribute the full 


WMA 


When I rebooted, 
I found the hard 
disk was 
scrambled, the 
CMOS was 
scrambled, and 
the install disk 
was sheet ae too 


UUM 


deeeddeeddeedededededddeeddedddeddda 


ddd 
version, and the object of spending this 
money is to get more money in. Once the 
product has been sold, you already have 
the money! Surely the star programmers 
should be making the demo, and the kid- 
dies making the product. 


Another observation in support of this idea 
is that, while it is true that even the best 
demo cannot guarantee a sale, a poor demo 
can rule one out. Any normal customer 
using a demo that crashes, or corrupts his 
disk, or abandons him when he gets con- 
fused will have a very poor impression of 
the company which is representing itself 
with the demo. ‘If they can’t get half the 
software to work’, he thinks, ‘what chance 
does the complete program have?’ 


Which brings me back to shareware. Share- 
ware authors understand the value of the 
demo - after all it is the only advertising they 
have! These authors are able to earna living 
entirely on the quality of their product - 
they charge small fees, and get paid only if 
the product is what is wanted by the cus- 
tomer, Although many of these programs 
have been limited in some way, there is ab- 
solutely no point offering a program which is 
crippled to the point of unusability, since the 
customers will not be able to asses it. 


Few non-shareware companies offer 
demonstrations of this quality. The not- 
able exceptions are Microsoft, with its 
demo of Excel (even though it is stuck in 
Windows 2), and SPC with its demo of 
Professional Write Plus. Both these demos 
really worked, and both were showing the 
ease with which the products could be 
used. They were, in short, great demos of 
great products, 


In contrast, many demonstrations are 
dreadful. Often the products they are 
demonstrating are not much cop, but 
often they are not bad or even quite good. 
A grotty demo for a grotty product is 
hardly surprising (and is certainly a fair 
representation) but itis this second group 
which we have reserved the awards for - 
the good products which are let down by 
bad demos. It is traditional to say that the 
ecision was very difficult, but it was 
certainly true in this case - all the conten- 
ders were truly awful! 


After much deliberation, I decided that 
the runner-up would have to be MathCad 
for Windows. The demonstration had 
more functions disabled than enabled, 
and what they distributed was little more 
than a calculator. The really striking part 
of it, though, was the installation. It came 
with a demonstration copy of Windows, 


= 


which it installed automatically. The 
printed notes gave instructions about how 
to run the installer, but tucked away in a 
readme were instructions about how to 
suppress the installation of the demo 
Windows, so that an existing Windows 
installation wasn’t destroyed. Following 
these instructions loaded the demo Win- 
dows anyway. My installation took two 
days to repair. 


Not only did the instructions not work, 
but they should have been unnecessary 
in the first place. Because a Windows 
program file can contain a DOS program 
as well, there should have been two dif- 
ferent installers in the same file - only the 


a 


DOS mode program should have installed 
the demo Windows. The prize is offered in 
recognition of sloppy design and sloppy 
programming. 


But the first prize, for the world’s most 
awful demo, goes to a program which was 
quite impossible to asses because it never 
got started, After typing ‘install’ as per the 
instructions, the unpacker went to work, 
and then stopped. The machine was dead. 
When I rebooted, I found the hard disk was 
scrambled, the CMOS was scrambled, and 
the install disk was scrambled too. Three 
different disks all produced the same result. 
Their master disk was corrupt, yet nobody 
had even noticed! 


SS 
~ 
i 


Mayhem 


Y 


VV k A 


Luckily I had installed this on my quaran- 
tine machine, so no real damage was done. 
But Harvard Graphics for Windows is de- 
signed to be used by users, not pro- 
grammers, and the damage could have 
been considerable. 


Congratulations to SPC - your ‘Thanks for 
Nothing’ award is in the post to you now! Our 
thanks go to the gallant losers, and don’t lose 
hope, it may be your turn next time. 


EXE. 


Jules is an independent programmer and 
consultant who can't find an apposite joke 
this month. He can be contacted on 0707 
44185 or on CIX as jules. 
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Nobody... but 
most end users are 
not adept enough 
fo use the popular 
report writers. That’s 
why we have 
created Grumpfish 
Reporter. 


Grumpfish Reporter is a full-fledged 
report and ad-hoc query manager. 
Its intuitive pull-down menu structure 
allows end users to be productive 
immediately without having to over- 
come a steep learning curve. In the 
Grumpfish tradition, Grumpfish Re- 
porter is written 99.9 percent in 
Clipper 5.01, and well-commented 
source code is available. This 
means that Clipper 5.01 developers 
can link any or all Grumpfish Re- 
porter modules directly into their 
applications. 


Grumpfish Reporter features: 
e the ability to create multiple data 
dictionaries. 


eassign security levels and/or 
passwords to data dictionaries. 


ata is useless 
without output reports, 
but who likes coding them? 


e linking databases on more than 
one field through the use of 
pseudo-fields defining the rela- 
tionship. 


assign meaningful names to both 
fields and database files to hide 
complexity from the end user. 


context-specific help for each 
field in a data dictionary. 


ecan use existing indexes rather 
than rebuilding them each time. 


pseudo-fields that can contain 
any valid Clipper expression, in- 
cluding look-up arrays and func- 
tion calls (even user-defined func- 
tions will work if you are using the 
Developers Version). 


parent-child- grandchild relation- 
ships. 
output to screen, printer, ASCIl, 


DBF, Lotus/Quattro spreadsheet 
files, and form letters. 


unprecendented interactive screen 
output — columns can easily be 
moved/deleted/inserted. The de- 
veloper can also attach specific 
colors to flag certain data condi- 
tions onscreen. 


numerous query criteria including: 
equality, less than, greater than, 
inequality, empty, contains, posi- 
tional contains, begins with, end 
with, sounds like, between. 


e free-format object-oriented screen 
painter. 


¢ 25/43/50 line mode 
e on-line context- specific help. 


QBS 
10 Barley Mow Passage « London « W4 4PH 


Fax: 081 994 3441 + Tel: 081 994 4842 » BBS: 084 747 1979 


Grumpfish 
2450 Lancaster Dr. N.E., Suite 206 ¢ Salem, Oregon 97305 USA 
Tel: (503) 588-1815 e Fax: (503) 588-1980 e BBS: (503) 588-7572 e CompuServe: 70673,355 


> CIRCLE NO. 128 


e plain English ad-hoc querying 
facility, including the ability to 
add/edit/delete specific query 
conditions. 


e multiple printer support. 
e support for FlexFile™ memo fields. 


e totals/averages/maximum/ 
minimum/ deviation/variance for 
numeric fields. 


e Developers Version is not only 
linkable, but entirely overlayable 
by Blinker, RTlink, and Warplink. 


© 100% multi-user compatible. 


¢ 30 days free voice support, two- 
year unlimited free BBS support. 


¢ Printed documentation, Norton 
Guides reference database. 


The base Grumpfish Reporter pack- 
age includes a stand-alone execu- 
table file for use by either the de- 
veloper and/or end user. The op- 
tional Developer's Version includes 
the Clipper 5.04 source code, which 
enables you to link any or all of 
Grumpfish Reporter directly into 
your Clipper application. 


Grumpfish Reporter Developers Version 

includes a limited run time version of 
Class(y), which is published 
by IDC. 


SO SI INI TITAS IIS 
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Persistent Programming 
Prose with POET 


If relation tables and ‘Fifth Normal Form’ give you an upset stomach, try using POET, 
an OODBS that stores your data on disk in the same form you created it in memory. 


Writing database applications has always 
made me ill, but I didn’t realise why until I 
first saw the ads for the POET Object 
Oriented Database (OODBS) library. Of 
course! After I've spent all that time con- 
cocting the structure to hold my data in 
memory, why should I have to massacre it 
before saving to disk? There are enough 
things to remember (let’s see, tomorrow I 
need to buy cat food, the phone bill is due, 
got to fix that dangling pointerin TEDIT.CPP, 
...) Without adding to the list yet another 
way of representing the same old data. 


RDBMS Problems 


One of the biggest problems with relational 
databases is that whatever data your appli- 
cation has must somehow be shoehorned 
into a flat table (or series of flat tables), with 
each column of the table being one of the 


ance (and the resemblance to your nifty 
in-memory data structure) goes out the 
window when one-to-many relationships 
are introduced into the design, as this re- 
quires creation of a new table with each 
row containing a key to the ‘one’ and a key 
to one of the ‘many’s. For example, Figure 
1 shows an example of part of the data 
schema for a CruiseShip - note the 
extra table required to keep track of the 
‘many’ first _names of each Person 
on the boat. (Yes, I realise that I could 
probably get by with just making one ex- 
tremely long first _name field, but play 
with me for example’s sake - assume that a 
passenger could have an infinite number of 
first_names), Especially painful is the 
space wasted for all those ‘person#’ 
fields. 


Many to Many relationships are even 


fields of the data record. This method works | worse. For example, if we say that an 
fine for simple data structures which have | Owner can own more than one boat, and 
only one-to-one relationships. But the eleg- | each boat can have several partial owners, 
Person | person# | person_type | lastname | address | age | sex 
FirstNames | person# | first_name 
Passenger | person# | class | cabin 
CrewMember | person# | salary | position 
Owner | person# | capital 
CruiseShip | ship# | tonnage | capacity 
‘ Ti 
ShipOwn | ship# | person# | ;for M:M relation 


Figure 1 - RDBMS data schema for Cruise Ship 


we'll have to create an artificial table (Shi - 
pOwn) whose only purpose is to show the 
Many-to-Many relationship. This table is an 
artefact of RDBMS design, nothing more. 


More problems arise if there are any records 
which have common fields with other rec- 
ords (ie inheritance). In Figure 1, Pas- 
sengers, CrewMembers, and Owners 
are also Persons, Putting their common 
fields (Last_name, name, address, 
age, sex) into one table and their unique 
fields (class and cabin for Passen- 
gers, salary and position for 
CrewMembers) requires putting a per- 
son_type flag in the Person table in- 
dicating which type of Person this data is 
for, and results in complicated updates 
where you update rows in multiple tables 
to properly process a single record. If one 
of these tables is inadvertently forgotten in 
an update (or delete) somewhere, the data- 
base could become corrupt. 


If you decide to add a new field to one of 
these tables... Forget it! RDBMSs’ lack of any 
standard notation to enforce the grouping 
of data and their related functions opens the 
door to insurmountable maintenance hea- 
daches. As all fields in all tables are con- 
sidered ‘public’, any programmer who 
knows the layout of the database can (and 
will) do whatever he wants with any data 
item, anywhere in the database. Including 
introducing invalid values into the system, 
Curses. 


Or what if you want to add a new type of 
Person (Stowaway, maybe)? RDBMSs 
don’t understand Polymorphism, so you'll 
have to add another possible value for the 
person_type flag and update your en- 
tire program to check for this new value. 
The result will be programs littered with 
switch (or CASE, or [shudder nested 
IF-THENs) testing person_type to 
see which kind of record this is. 
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OODBS Solutions 


An Object Oriented Database (OODBS), 
addresses all of the above problems, and 
many more. In simple terms, an OODBS 
allows the programmer to make certain ob- 
jects ‘persistent’ (ie they outlive the life of 
the program’s run-time) and store them in 
a database in exactlythe same (logical) way 
they are stored in main memory. These 
persistent objects can then later be read 
back from the database, with all data fields 
and relations (pointers to other objects) 
intact, Gone are the days of converting your 
beautiful data structures to ‘Fifth Normal 
Form’, 


Even more important, the reread objects 
will also preserve their inheritance struc- 
ture (member functions of the original class 
and its ancestors will still work), encapsu- 
lation (access rules for data members will 
be retained and enforced just as before the 
object was stored), and polymorphic infor- 
mation (calls to virtual member functions 
will execute the proper version for the orig- 
inal object). 


Finally, persistent objects stored in an 
OODBS will always preserve their ‘ident- 
ity’. Each persistent object has an identity 
assigned to it when it is created. The 
OODBS makes sure that there is always one 
and only one copy of this object in memory. 
Ifyou attempt to read the same object twice, 
the OODBS notes this and sets the pointer 
for the second read to point to the original 
object which is already in memory. This is 
different from traditional databases, where 
the records read into memory are merely 
copies of the data on disk (leading to ‘data 
recursion’ problems when there is a circular 
reference in the relations of a set of data 
which is being updated - some updates may 
not be registered). 


Class Registration 


How does this work? Think of a disk-based 
virtual memory system which mirrors se- 
lected in-memory objects, their charac- 
teristics, and their connections via pointers. 
On disk, the characteristics are represented 
by ‘class registrations’ (the database must 


£o/ 


POET 


persistent class CruiseShip; 
persistent class Person 


i 
CruiseShip * boat; 
cset<PtString> first_names; 
PLSLiiny last_s 
PtString addre: 
int age; 
char sex; 

public: 
virtual int Input (); 
virtual void Display (); 
useindex lnameIndex; 

}; // class Person 


// 1M 


Person 
// 1st 10 char of Iname 


indexdef InameIndex : 
{ Iname[((10}]# }7 


persistent class Passenger : 
{ 
char class; 
int cabin; 
public: 
int Input (); 
void Display (); 
}; // class Passenger 


public Person 


persistent class CrewMember : 
if 
long salary; 
PtString position; 
public: 
int Input ()7 
void Display (); 
}; // class CrewMember 


public Person 


persistent class Owner : 
{ 
eset<CruiseShip *> boats; // 1:M 
long capital; “ 
); // class Owner 


public Person 


MIM 

persistent class CruiseShip 

( v 

cset<Owner *> owners; // 1M 

int tonnage; 

int capacity; 

cset<CrewMember *> motleycrew; 

hset<onDemand<Paasenger>> passengera; 
public: 


oy 


Figure 2 - Persistent class definitions for OOP Cruise Ship 


OODBS), and the connections are repre- 
sented as virtual-space addresses or, more 
correctly, ‘identity numbers’. 


When an object’s data are read into mem- 
ory, its class registration is used to create an 
in-memory object of the proper class, At the 
same time, all related objects are also auto- 
matically read and the pointers to these 
objects are changed from identity numbers 
to the objects’ addresses in main memory. 
Toaccess the related objects, just use stand- 
ard C++ pointer dereferences, as you would 
with any ‘normal’ object. 


When writing back to disk, the opposite 
operation takes place - the identity number 
of all objects pointed to by this object are 
stored in place of those objects’ memory 
address. Although an object’s address in 
main memory will change from time to time 
as it is read and forgotten, its identity re- 
mains the same from birth until it is deleted 
from the database. (An object's class regis- 
tration is stored the first time the object is 
stored, and is also never modified.) 


To make sure that there is always just one 
copy of an object in memory, a surrogate 
pointer table containing identity-address 
pairs is maintained by the OODBS at run- 
time. Whenever a read of an object with 
Identity ‘n’ is requested, the surrogate 
pointer table is first searched to see if that 


turned. As objects are ‘forgotten’, a counter 
kept by the surrogate table is decremented; 
when the counter goes to 0, the object is 
cleared from main memory. 


POET 


Although the general ‘what’ information 
above is (more or less) common to all 
OODBSs, the ‘how’ information is a rough 
description of how the POET (Persistent 
Object Extended database Technology) 
OODBS system, from BKS software of Ber- 
lin, works, POET is implemented as a class 
library in combination with a few exten- 
sions to the C++ language to support per- 
sistence, It is currently available for 
Zortech, Borland, and Microsoft C++ com- 
pilers for either Windows or DOS, as well 
as assorted UNIX systems and GNU C++ on 
the NeXT. Although there are other 
OODBSs on the market, POET is distin- 
guished from all the others by having a base 
price of under £250 (compared to &7,000+). 


POET’s most prominent extension is the 
new ‘persistent’ keyword. Any class 
declared as persistent can be 
Store () edorGet () ed froma database. 
persistent immediately precedes the 
word class ina class definition: 


persistent class foo 


{ 
public: 


int x; 
i 


be informed beforehand aboutall classes of | object already resides in memory. If so, the 
objects which will be stored in the | address from the surrogate table is re- 

Name File Name Purpose 

Class Dictionary in database db schema 

Class Factory base.cxx build functions for objects 

Class Factory Header base.hxx class desc. 

User Class Header MYAPP.HCD persistent class defs 

Compiled User Class Header MYAPP.HXX precompiled pers. classes 


How to Use 


PTXX maintains automatically 

Compile & Link to your application 

inc. by base.cxx 

you write, PTXX compiles to .HXX 

PTXX creates, you include in MYAPP.CXX 


Figure 3 - Components in a POET project 
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and create should never be 
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At the minimum level, that’s all there is to 
declaring a persistent class, just precede the 
original definition with ‘persistent’.A 
persistent class can have member functions 
(including virtual), private and 
protected data, and everything else a 
standard class can. (One unfortunate ex- 
ception is that a persistent class can only be 
derived from another persistent class.) Fig- 
ure 2 shows the persistent class definitions 
for the CruiseShip data base. 


Predefined POET classes 


POET has several predefined classes that I 
have used in the class definitions of Figure 2. 
These classes are provided by BKS because 
the data they represent have strange seman- 
tics that must be understood directly by the 
Type Manager in POET. POET’s persistent 
classes can hold any kind of data which is a 
standard C++ type or arrays and structures 
combining several items of those types, but 
variable length data and data with unusual 
sorting orders require special treatment. 


Although it is possible for you to add your 
own ‘weird’ types to the POET Type Man- 
ager, BKS discourages this and tries to 
eliminate the need for it by providing 
Pt String (a variable length string class), 
PtDate and PtTime (unique due to 
their sorting characteristics) and several 
types of set - cset, lset and hset 
(variable size container classes for repre- 
senting one-to-many relationships). The 
POET Type Manager has already been ac- 
quainted with these classes, so you can use 
them without worry. 


Precompiling 


As standard C++ doesn’t recognise the 
persistent keyword (or other key- 
words added by POET), the class defini- 
tions you write must be preprocessed to 
generate something acceptable to the com- 
piler. POET does this with a precompiler 
called PTXX (The DOS version uses a com- 
mand line utility, the Windows version has 
an IDE much like TC++ for Windows). 


Persistent class definitions are stored in a file 
with extension .HCD. The PTXX compiler 
then processes the HCD file 1) to create HXX 
files based on the .HCD but understandable 
by a C++ 2.0 compiler, and 2)to inform the 
database about the classes of objects which it 
will contain and create a .CXX file with class 
factory ‘object creator functions’ for each per- 
sistent class. A single project (and single da- 
tabase) can use more than one .HCD file, and 
the same .HCD file can be used for more than 
one project (and database). 


Your project’s .CPP (or .CXX) files #in- 
clude the .HXX file generated by PTXX, 
not the .HCD file. After PTXX has com- 
pleted with no errors, you can then compile 
and run the program. Figure 3 isa list of the 
components of a POET project. 


Opening and Closing 


POET databases are encapsulated in ob- 
jects of class Pt Base. Before storing or 
retrieving any objects in the database, 
PtBase: : Open () mustbe called. Also, 
to preserve source compatibility with 
client/server versions of POET (for which I, 
woefully, have no information), we must 
also Connect () to a server (always 
"LOCAL" for single user versions). 


Closing the database is a simple comple- 
ment of opening, with calls to Close () 
and DisConnect (). Figure 4 illustrates 
these operations. 


The name given fora database, by the way, 
is not the name of a file, but the name of a 
directory which contains several files. each 
database must therefore be in a separate 
directory, which makes perfect sense any- 
way (it certainly makes organising daily 
back-ups easier), 


Storing Objects 


Creating or modifying an object of a persist- 
ent class doesn’t automatically store that 
object in the database. The program must 
store it explicitly. Although this at first 


int main() 
{ 
PtBase objbase; 
objbase.Connect ("LOCAL") ; 
ob jbase.Open ("base") ; 
// enter some passengers 
do { 
Passenger *p = new Passenger; 
int r = p->Input(); 
if (r) 
{ 
p->Assign (objbase) ; 
p->Store(); 
} 
p->Forget ()7 
}) while (r); 


// vead and Display all Persons 
Person *p; 
PersonAllSet *pset = new PersonAll- 
Set (objbase) ; 
pset->Seek (0, PtSTART); 
do { 
pset->Get (p) + 
p->Display(); 
pset->UnGet (p) ; 
} while (pset->Seek (1,PtCURRENT) == 
OF 
ob jbase->Close (); 
ob jbase->DisConnect () ; 
return 0; 


} 


Figure 4 - Using POET for simple storage and retrieval 
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POET 


seems to contradict the idea of ‘persist- 
ence’, it is much more efficient and useful. 
Not only does the program save time by not 
storing an object to disk when it isn’t 
necessary, the same classes can also he 
used for non-persistent objects. 


An object must be assigned to a database 
before storing it for the first time. The 
Store () andAssign() member func- 
tions are automatically defined for any per- 
sistent class, 


Once we are finished using the object in 
memory, we can Forget () it. Don't let 
this confuse you! Forget () is not the 
same as Delete () (which removes the 
object from the database). Forget () 
merely says ‘I don’t need this item in main 
memory any more. If nobody else needs it 
either, you can remove it’. In more technical 
terms, Forget () decrements the counter 
in the surrogate table I mentioned above, 
calling the standard C++ delete operator 
when the count reaches zero. If the object 
has been stored in the database, it remains 
there. (You shouldn't call delete for persist- 
ent objects yourself, by the way.) 


In Figure 4, Assign (), Store (), and 
Forget () are used to store new Pas- 
sengers to the database until Pas- 
senger: : Input () returns 0. 


Simple Retrieval 


Two utility classes are automatically cre- 
ated by PTXX for every persistent class 
‘xxx’: KXXA11Set and xxxQuery. An 
xxxAl1Set object is a special type of 
POET set that contains all objects of that 
class currently in the database. In our 
example in Figure 2,a PassengerAll- 
Set would contain all Passengers, and 
a PersonAllSet would contain all 
Persons in the database (including all 
Passengers, as they are also Per- 
sons). After an Al1Set is related with a 
database, its member functions can be used 
to access all objects of that class con- 
tained in the database. The second loop 
in Figure 4 also shows how we could use 
PersonAllSet::Get() to Dis- 
play () allPersonsin the database. Note 
that if the Person retrieved was actually a 
CrewMember, CrewMember: :Dis- 
play () would be called, just as you 
would expect for non-persistent objects. 


Every Get () from a set should have a 
matching UnGet () after you are finished 
with the object. I can’t quite see the difference 
between xxxAllSet::UnGet (xxx 
*) and xxx: :Forget (), and I gather 
from the documentation that, in the current 
version anyway, there are no differences. 
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Limitations 


Although POET has incredible features which 
have sparked in me a new interest in database 
projects, there are still some limitations in the 
current version (1.1). Some of these limita- 
tions are because of the version, some are 
inherent to this design, or to OODBSs in 
general. 


At the top of my list is the fact that having 
variable sized member data, or member clata 
requiring different comparison methods, is 
only possible with modifications to the Type 
Manager, which is discouraged. (The infor- 
mation to do this modification is not even 
given in the manual, but will be provided ‘On 
demand’ by BKS.) 


Another problem is that an object in one 
database cannot have a reference to an object 
in another database. This means that, for 
example, a data vendor can’t sell ready-made 
‘zipcode’ database files in a form easily usable 
within a program - anartificial ‘relation’ would 
have to be set up in the database, more or less 
creating an RDBMS layered over the OODBS. 


Still another problem is that currently there 
is no utility for recovering a corrupt data- 


base. Also along the lines of file mainten- 
ance is that class versioning is not automat- 
ic, and requires the PTXX program to work. 
This means that when a class in a cus- 


MMU 


POET has 
incredible 
features which 
have sparked in 
me a new interest 
in database 
projects 


WML 


tomer’s application changes, you'll either 
have to bring PTXX to the database, or 
bring the database to PTXX, neither of 
which is inviting. 


The advantages far outweigh these small 
inconveniences, though. 


POET 


To Be Continued... 


You now have a decent overview of ‘what’ 
POET can do, anda bit about ‘how’ it does it. 
The next question is ‘how fast? (BKS says 
‘faster than RDBMS’, but thatsounds too good 
to be true...) 


Inthe meantime, if you know somebody who 
already has POET, borrow their reference 
manual for a day and read it. You may find 
yourself a new religion, 
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Managing to ‘lay off the caffeine’ for over a 
month, Laine was driven back to bis worst 
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the final grades 6 days early. 
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PC Tech BBS (0101 612 345 4656, evenings 
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Laine Stump, Bilkent University, Lojmanlar 
3/9, 06533 Bilkent / Ankara, TURKEY. 


POET is distributed in the UK by Silicon River 
(081 317 7777). Prices start from £249. 
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Encapsulation 


Using Encapsulation 


Borland’s Zack Urlocker uses a TPW poker game to illustrate the value of encapsulation. 


Although inheritance is often the first thing 
people think about when using object- 
oriented programming, encapsulation is 
equally valuable in facilitating mainten- 
ance. To illustrate the concept of encapsu- 
lation, I’ve written a five card video poker 
game for Windows, similar to those quar- 
ter-sucking machines found in Las Vegas. 
Mine was inspired by a ski trip to Lake 
Tahoe, Nevada, and is called ‘Tahoe 5’, 


Let’s take a look at why encapsulation is so 
important. Encapsulation is the ability to 
combine code and data into a single entity, 
which we call an object. This is not an entirely 
new concept; it’s a refinement of the idea of 
abstract data types as exemplified in Ada and 
Modula-2. The idea of an abstract data type is 
simply that you should be able to manipulate 
the data without regards to its physical struc- 
ture. The classic example is the idea ofa stack 
which might be represented as an array or 
linked list. Itcan be manipulated independent 
of its physical representation using high level 
operations such as ‘push’ and ‘pop’. 


Encapsulation gives us a higher level way 
of modularising our code than is practical 
in traditional languages. The idea of com- 
bining code and data together makes sense, 
because we never accumulate data without 
some purpose or functionality in mind. 


Encapsulation and Privacy 


One of the notions that is important in 
encapsulation is privacy, or the ability to 
restrict access to the internal data structures 
of an object. So not only should you not 
have to know the internal structure of an 
object, you should not be able to know. 
Privacy is important to prevent users of 


The ‘pure’ OOP languages like Smalltalk 
and Actor illustrate the two extremes of 
implementing privacy. Both languages 
fully support encapsulation, but they differ 
in how they enforce privacy. In Smalltalk, 
fields in an object (known as ‘instance vari- 
ables’) are always considered private and 
cannot be accessed from outside the object. 
In Actor, these fields can be accessed directly 
by using familiar ‘dot notation’ the same way 
you access fields in a record in Pascal or C, 
Although this is potentially less safe, with 
proper discipline it is nota problem. 


Both Pascal with Objects and C++ provide the 
programmer with more control to determine 
the suitable level of privacy. In Pascal with 
Objects the keyword private is used to 
designate fields or procedures inside an ob- 
jectas being inaccessible to the outside world. 


This makes it easy for the builder of reu- 
sable objects to lock out access to certain 
attributes, thereby eliminating the possi- 
bility of dependencies upon the implemen- 
tation. However, the question arises as to 
whether descendants of an object type (that 
is derived classes in C++ jargon) should 
have access to the private fields or not. C++ 
addresses this problem by adding a second 
type of privacy called protected which 
allows you to declare fields as private to the 
outside world, but still allow access to 
derived classes. 


One can imagine a third type of privacy that 
implements a ‘read only’ capability, so that 
outside objects can access a field inside an 
object to read its value, but cannot over- 
write the value. Although I don’t know of 
any OOP language that implements this 
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Figure 2 - Encapsulation of objects in Tahoe 5 


technique, it can be simulated by making 
the field private and providing a public 
function to read, but not modify, its value. 


The Challenge 


The challenge of object-oriented design is 
to come up with a set of objects that will 
facilitate maintenance and reusability. Each 
object should include all necessary data 
and functionality to serve a well-defined 
purpose in the system and minimise de- 
pendencies upon other objects. 


Encapsulation must balance convenience of 
access to data as well as protection of internal 
data structures from external dependencies. 


The Game 


The Tahoe 5 program consists of five source 
code files and one resource file as listed in 
Figure 1. The unit interfaces are printed in 
Figures 3 through 6. The complete code is 
available on disk from .EXE free of charge - 
see the note at the end of the article. 


Each file defines objects fora limited purpose. 
Rather than making one massive object that 
does everything, we break our application 
down into finer granularity, more reusable 
objects. Of course, it’s not easy to decide 
which capabilities belong together in an ob- 
ject, but I'll try to point out examples. 


The application object is a TPokerApp 
and is contained in the main program file 
TAHOESW.PAS. The application object is 
quite simple; it simply creates and shows a 


main window and at which point the user 
is in control, All other behaviour for the 
application is inherited from the generic 
TApplication type. 


The main window is a TPokerWindow 
object that manages the user interface to the 
game. It inherits a fair amount of its capa- 
bility from the generic TWindow object, 
though itadds methods for dealing, holding 
cards, managing bets and, of course, dis- 
playing the cards, Drawing of the bitmaps 
is done in a separate function DrawBit- 
map, since I had used this code in a pre- 
vious program. 


[he rules of the game are defined in the 
TPokerHand object. Thus 
TPokerHand object contains a deck of 
cards, the cards dealt for the hand, the 
current bet, and a procedure for evaluating 
the hand among others, 


The lowest level objects in this application 
are TCard and TDeck defined in the 
CARDS.PAS file. A card is really little more 
than a record with two numeric values for 
the face and suit and some methods for 
setting and getting the value of a card. The 
functions get Val and set Val allow us 
to deal with a card as a unique value from 
to 52, which is convenient when dealing 
cards. The deck itself consists of an array 
to keep track of whether particular cards 
have been dealt and a function for return- 
ing the next card by generating a random 
number. Shuffling the deck is done by 
creating a new initialised deck and calling 
a randomize function. 


[FOOSE EOS EI ISOS IOO III ISR IAS 


{ TSWin  -- Tahoe 5 Card Poker ) 
( Windows display unit 
(Urerererreeeereceerccrecceccceccecccecs cs 3) 
Unit TSWin; 

interface 


uses drawBits, Poker, Cards, 
Wobjects, WinTypes, WinProcs, 
Strings, StdDlgs; 

const 


cm_Deal = 201; { menu items 
cm_Exit = 208; 

em_About = 209; 

cm_incBet = 301; 

cm_decBet = 302; 

cem_hold 401; 

cm_Help = 600; 

bkgrnd = $008000; { Green felt b/ground 
frgrnd = $f££££££; { White text £/ground 
type 


{ The window responds to messages and 
controls the user interface. ) 

PPokerWindow = *TPokexWindow; 

TPokerWindow = object (TWindow) 
Hand : TPokerHand; 
dealt, finished : 
Button : PButton; 
constructor Init (AParent: 
BWindowsObject; 


boolean; 


ATitle: PChar); 
procedure setupWindow; virtual; 
procedure GetWindowClass 

(var WndClass: TWndClass); virtual; 
procedure newGame; 
procedure deal; 
procedure bet (amount: integer) ; 
procedure hold (key: integer) ; 
procedure showHoldCard(card: integer); 
procedure showHold; 
procedure showBalance; 
procedure showHand (delay:boolean) ; 


procedure showDraw; 
procedure drawCard(card:TCard; 
xrinteger) ; 
procedure showEval; 
{ menu response methods } 
procedure dealCmd(var Msg: TMessage) ; 
virtual cm first + cm_deal; 
procedure incBetCmd(var Msg: TMessage) ; 
virtual cm_first + cm_incBet; 
procedure decBetCmd(var Msg: TMessage) ; 
virtual cm first + cm_decBet; 
procedure dealButton(var Msg: TMessage) ; 
virtual id_first + cm_Deal; 
procedure incBetButton (var 
Msg: TMessage); 
virtual id first + cm_incBet; 
procedure decBetButton (var 
Msg: TMessage) ; 
virtual id first + cm_decBet; 
procedure About (var Msg: TMessage); 
virtual cm_First + cm_About; 
procedure Ilelp(var Msg: TMessage) + 
virtual cm First + cm Help; 
procedure Exit (var Msg: TMessage) ; 
virtual cm First + cm_Exit; 
{ windows message response methods } 
procedure wmCommand(var Msg: TMessage) ; 
virtual wm_command; 
procedure Paint (DC: HDC; 
var PaintInfo: TPaintStruct); 
virtual; 


procedure wmLButtonDown 
(var Msg: TMessage); 
virtual wm_LButtonDown; 
procedure wmRButtonDown 
(var Msg: TMessage) ; 
virtual wm_RButtonDown; 
procedure wmSize(var Msg: TMessage) ; 
virtual wm_Size; 
end; 


Figure 3 - Interface section of TSWIN.PAS 


Encapsulation 
{ POKER -- Tahoe 5 Card Poker } 
{ Poker playing unit , 


ferrreseecerstesecerescectsrerterr errr errs) 
Unit Poker; 
interface 
uses Cards; 
const 
nothing 
jacks 
twoPair 
threeKind 
straight 
flush 
fullhouse 
fourKind 
straight flus! 
royalflush cy 
eval : array(0..9] of string = 
( ‘Nothing!", ‘Jacks or better.’ 
‘two pair.','Three of a kind.', 
'straight.’, ‘Flush.’ 
‘Full house.’, ‘Four of a kind.’ 
‘Straight flush.', 
‘Royal flush!'); 
payoff : array(0..9] of integer = 
(Ln de i2p By. Mi: Se 18> 25, 150,250) 
type 
(The Poker Hand defines the rules of play 
and manages the game } 
TPokerHand = Object 


deck : TDeck; 

Balance : integer; 

cards : array(1..5] of TCard; 
held : array(1..5] of Boolean 
val: 0.49; 

bet : integer; 


procedure init; 
procedure deal; 
procedure hold (card: integer) ; 
procedure eval; 

end; 


Figure 4 - 
Interface section of POKER.PAS 


Figure 2 shows a diagram that illustrates the 
relationship between the objects of the ap- 
plication. 


Choosing objects 


Although it’s fairly clear that you want to 
break the program into separate objects for 
the TApplication, TCard and 
TDeck, separating the responsibility be- 
tween other objects is more difficult and is 
worth examining in more detail. 


For example, consider the control of the 
user interface. The user interface in a poker 
game is essentially modal. You can only bet 
before cards are dealt. You can only draw 
cards once, after they've been dealt. And 
the hand is evaluated only after you are 
dealt the newly drawn cards. This implies 
that TPokerWindow object must imple- 
ment some of the rules to control the play 
of the game. But wait a minute! That’s the 
role of the TRPokerHand object. Splitting 
the responsibility for implementing the 
rules of the game flies in the face of having 
distinct purpose for our objects, What are 
the alternatives to this dilemma? 


It is possible to have the user interface 
simply pass through all user commands, 
disregarding any aspect of modality, and 
leave the responsibility for validating com- 
mands to the TPokerHand. This might 
enable us to have more clear separation of 
purpose between the objects, but para- 
doxically it increases the dependency be- 
tween them. This reflects the fact that the 
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user interface isn’t smart enough to be com- 
pletely functional and is therefore more 
dependent upon the poker hand's rules. 


Another alternative would be to combine 
all of the poker playing capabilities directly 
into the window object. In this case we 
would have direct access to all of the infor- 
mation we need and minimise communica- 
tion between objects. However, we would 
then lose the ability to untangle the user 
interface from the logic of the game - some- 
thing that could be important if we wanted 
to create a different user interface for the 
game, perhaps on another platform, 


The best solution depends on what you're 
trying to achieve. Reusability is an admirable 
goal, but you may need to'specify your objec- 
tives more clearly. Do you want to port the 
application to a different platform? Or do you 
need to create similar applications on the 
same platform? Or will you need to modify 
the existing application for different vari- 
ations? Each of these situations might compel 
you to chose a different approach. 


Let me tell you how I ended up with the 
design I chose. | originally wrote Tahoe 5 for 
the Pocket PC (aka the Atari Portfolio), a 


pint-sized palmtop that runs DOS (the DIP 
Operating System) on a 40 character by 8 
line display. I never intended to port the 
application to Windows, though I had 
thought I might like to reuse some of the 
code for a blackjack program on the same 
machine. 


It was pretty obvious to make reusable card 
and deck objects, even though they are 
only a few dozen lines of code. I also 
sketched out the basis of a TRokerHand 
object that would evaluate the hand. Since 
I didn’t really know how I was going to 
evaluate the poker hand, I concentrated on 
the user interface, 


Being somewhat impatient to see if it was 
possible to come up with a decent user 
interface on such a small machine, I de- 
cided I might as well hack out a prototype 
and see if it was going to be usable before 
I devoted too much time to the project. I 
wrote some global procedures that dis- 
played cards on the screen and let the user 
draw new cards, I also wrote a few minor 
functions to trap user input, display help 
and restore the screen. As necessary, I 
called dummy routines in the TPoker- 
Hand object. Since this was just a proto- 


Encapsulation 


type, I added global procedures to the dis- 
play unit somewhat indiscriminately. 


Once I decided the prototype was adequate 
and that the game would be playable, I 
needed to determine the next step. My first 
thought was to throw away the prototype 
and begin with a proper design. However, 
economy being the better part of reusa- 
bility, I realised that there was no reason to 


(prererececterrecererctcctt Trt etter atte rig 

{ CARDS -- Tahoe 5 Card Poker 

) 

{ Generic card and deck unit 

Unit Cards; 

interface 

const faceDown 
hearts 
diamonds 
clubs 
spades 


type 
TCard = Object 
face : 0..13; 
suit : 0,.47 
procedure init; 
function val : integer 
procedure setCard(f, s : integer); 
procedure setVal(v : integer); 
end; 
TDeck = Object 
dealt : array (0..52] of boolean; 
procedure init; 
function nextCard : 
end; 


integer; 


Figure 5 - 
Interface section of CARDS.PAS 
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occurrence. Now you can see that another variable is 
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PowerBuilder 


PowerBuilder is the most powerful 
and easy-to-use environment for 
building industrial-strength client/ 
server applications. It couples an easy, 
intuitive graphic-user interface with 
your powerful server-based relational 
(SQL) database. 

PowerBuilder takes the best char- 
acteristics of traditional systems and 
combines them with the best features of 
the new Windows-oriented, PC-based 
client/server architecture. 

Traditional development lan- 
guages like C or COBOL either don’t 
address the client/server world or are 
too cumbersome for MIS developers 
concerned with productivity. 

PowerBuilder takes a different 
approach. It lets you paint applications 
quickly and easily. And when your 
needs change, you alter them in min- 
utes, not weeks. 

Getting started is simple. Power- 
Builder lets you access all of its fea- 
tures from one central location, called 
the Power Panel. Anything you need 


to do is just a mouse-click away. 
a would like to: 


Receive a PowerBuilder Info Pack 
O Attend a PowerBuilder Seminar 
Evaluate PowerBuilder 
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Name: 


Pawerluilder 


Power Panel 
Thisisa powerful 
command center for 
the developer, which 
provides easy mouse- 
driven access to the 
entire PowerBuilder 
environment, 


j Son by 
© Author LD. 
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generated SQL. 


Window Painter 
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| [ines 


The main component of an application 
shown here with a DataWindow object, 
several PushButtons, RadioButtons,and 


aarninea 


Admiral Software Limited 


193-199 London Road, Camberley 


LL aeeeeeedeaededeedeeceeeeeeeeeeeeee EEE 


rewrite the low level display functions. I 
created a TDisplay object to contain all 
of the user interface routines. This also im- 
proved the organisation of the cade. 


When I later decided to move the poker 
game to Windows, I was pleasantly sur- 
prised that all of the non-user-interface 
code worked without a single change. I 
only had to write one new object, the 
TPokerWindowasa replacement for the 
DOS TDisplay object. The structure of 


the two units is somewhat similar, but the 
differences between the two environments 
are quite fundamental. Therefore I did not 
attempt to share code at the user interface 
level since this would either totally obfus- 
cate the DOS program or severely limit the 
Windows version. 


Reusing the code for another card game 
obviously depends on the similarity of the 
two games. For variations of 5 card poker 
such as ‘Texas hold 'em’, it would make 


ferro r reer re eerrr Ts weretteTred) 
{ DrawBits ker ) 
{ ap drawing unit ) 
Crcetrrererrteresterreertss rrr ceccrercrrds 


Unit drawbits; 
interface 

Wobject 
trin 
procedure 


uses 


: integer; 


implementation 
cons 


suit : array(1..4) of char 
OOHeY? 

{ Draw the bitmap r the location. 
If the bitmap able draw 

a generic ) 


procedure dr y: integer; 
var 
hb, oldBitMap : 
MemDC : HD 
card: T 


Bitmap; 


rd; 
array[0..91 of char; 


begin 
hb := loadBitmap (Hinstance, 
if hb <> 0 then 


pehar (xes)); 


begin 
Membc 
oldBitma 


ompatibleDC (dc) ; 

ject (MemDC, Hb); 

+ 71, y + 96, Mempc, 
Copy) ; 

2, oldBitmap) + 


begin 
card.init; 
card. setv. 


rectangle (a 
str (card. fai 


+25, y+5, trlen(s)); 
strPCopy(s, ‘no bitmap!) 
textout (de, x+2, y+60, trben(s)); 
end; 

end; 

begin 

end. 


Figure 6 - DRAWBITS.PAS 


Udo 
Encapsulation 


sense to factor out the common elements 
from TPokerHand and TPokerWin- 
dow and create abstract ancestors which 
define the common elements for both 
games. In the case of blackjack, the fun- 
damental structure is quite different be- 
cause it is a two player game, has no draw 
and uses a simpler pay-out scheme. Despite 
these differences, it would probably be 
possible to define an abstract ancestor that 
implemented betting and possibly dealing. 
But as much as I like reusability, I hate 
breaking a working program. So I'll bet on 
a sure thing and just reuse the truly generic 
card and deck objects. 


[EXE] 


Zack Urlocker is product manager for 
Turbo Pascal at Borland International and 
has taught object-oriented programming to 
thousands worldwide. He has a closet full 
of obsolete computers including several 
partially functioning Sinclair ZX81s, 


The complete code and resources to Zack's 
program is available on disk, Please send 
us your disk (obeying exactly the instruc- 
tions given on Page 1, Column 1, otherwise 
you may forfeit it, marking envelopes 
“TAHOE”. 
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Extending Clipper 


In the final part of his investigation into Clipper’s C and Assembler interface, James Ormrod 
looks at working with and without the LLIBCA library, and some internal mysteries. 


Using LLIBCA clude some LLIBCA functions (or their equi- 
valents), including strepy (), 


You can safely call most LLIBCA functions | strcat (), strncepy () and 
from your Extend System code. Some | strlen (), and the C startup/shutdown 
points for consideration are listed below: | code, If you link with Microsoft's LINK.EXE 


‘ H ; you should use the /NOE switch to tell the 
Specify LLIBCA as the last library on the | jinker to ignore duplicates. 


inker command line - this ensures refer- 


ences to duplicated symbols are resolved | po not use direct screen writes. Clipper’s 
from CLIPPER.LIB. Duplicated symbols in- | gi spbegin() and dispend() func- 


[fe wnnn nnn nnn nn nnn nnn nner enna nnn nnn n CLIPPER getenve (void); 
ENVARG.C - Environment and argument CLIPPER getenvv (void) ; 
functions for Clipper: CLIP getargc (void) 


_retni(__arge); 

getarge () ) 

0 to nArgs 
aadd(args, getargv(i)) 

next 

nEnvs 

for 


CLIPPER getargy (void) {( 
int arg = (ISNUM(1) ? _parni(1) : 0) 
_rete(_argv(arg]) 


getenve () 

0 to nEnvs 
aadd(aEnvs, getenvv(i)) 

next 


CLIPPER getenve(void) { 
int i = 0; 
while (environ[it+] != ‘\0'); 


Fe a ee an “/ 
retni(--i); 
f#include "extend.h" ta ala 
extern int order CLIPPER getenvv (void) 
extern char **_argv; int arg = (ISNUM(1) ? _parni(1) : 0) 
extern char **environ; “rete (environ (arg}) 
CLIPPER getarge (void) ; 


CLIPPER getargy (void); // BOF ENVARG.C 


Figure 1 - Environment and argument functions 


7 


STUB.PRG - shows show use of INIT/TERM 
functions. Link stubtinitterm+xsegs 
and run stub.exe to output: 


init/term functions in INI 


Before main() .MODEL LARGE ;; Note! 
Main +7 X segment for Far Init’s 
Before DOS XIFB SEGMENT WORD PUBLIC ‘DATA’ 
aaa alae taladetala alata */ XIFB ENDS 
function main() // Clipper code XIF SEGMENT WORD PUBLIC ‘DATA 
? "Main" XIE ENDS 
return NIL XIFE SEGMENT WORD PUBLIC ‘DATA 


XIFE ENDS 
i; X segment for Far Term’s 
i XSEGS.ASM sets up the C . XCFB SEGMENT WORD PUBLIC ‘DATA’ 
code to call these. XCFB ENDS. 


‘: XCF SEGMENT WORD PUBLIC ‘DATA’ 

void myinit (void); XCF ENDS 
void myterm(void) ; XCFE  SEGMENI' WORD PUBLIC ‘DATA 
void myinit (void) { XCFE ENDS 

printf ("Before main()")7 7 Pull in startup code from LLIBCA 
) EXTRN __acrtused:ABS 
void myterm(void) { }; Large model so FAR pointers: 

printf ("Before DOS"); EXTRN _myinit:FAR 


EXTRN _myterm:FAR 
Startup code loops around until 
XIFB == XIFE, Can call up to 
32 functions. 
XIF SEGMENT 

DD = _myinit 


) 
// EOF INITERM.C 


XIF ENDS 
XCF SEGMENT 
DD = _myterm 
XCF ENDS 
END 


+7 EOF XSEGS.ASM 


Figure 2 - Initialisers and terminators for Clipper 
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tions already use video buffering, as does 
Nantucket Tools II, and this is set to become 
part of future releases. You can manipulate 
screens indirectly by calling Clipper’s 
savescreen() function and passing 
the resultas a character string toa C routine. 
Be aware that the resulting string will con- 
tain embedded control characters, includ- 
ing chr (0) (the C string terminator), The 
manipulated string can then be returned 
and rest screen () used to redisplay it. 


Watch memory. Avoid malloc (): al- 
though it may work under some circum- 
stances the resulting code will be unstable 
(C code written for earlier versions of Clip- 
per may include calls tomalloc () which 
need to be stripped out or pre-processed - 
see Figure 4), Watch, too, for C functions 
that call malloc () , especially third party 
libraries designed for C and not for Clipper 
(if you get into real trouble, try writing stubs 
for malloc() and free() that call 
_xalloc()/_xfree() - if you link 
them in before LLIBCA they will override 
C’s own and might just get you out of a 
hole). Ona similar topic, if you wantto shell 
out from a Clipper program buy an add-on 
- otherwise you're guaranteed hours of fun 
with spawn (). 


If a floating point number appears cor- 
rupted it is because Clipper has its own 
floating point handling routines which are 
not compatible with some C library func- 
tions. The number itself will be maintained 
correctly, you just might not be able to 
printf () it. 


Not using LLIBCA 


The problem with LLIBCA is that you have 
to own C to have it. You cannot ship any 
part of the LLIBCA code, even in OBJ for- 
mat, without prior agreement from Micro- 
soft. Fortunately there is a lot you can do 
with C without LLIBCA. 


Because Clipper is written largely in C, 
CLIPPER.LIB already contains some LLIB- 


System Science 
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Unix 
SCO Unix Op. Sys SCO Dev Sys. 
SCO Open Desktop (new version 2) 
SCO TCP/IP & NFS FTP PC/TCP 
Interactive Unix Op Sy / Architect Series 
Informix 4GL & SQL RM Cobol-85 
LPI Compilers C Scape Screen Lib 
LPIC++ for 386 Unix & Sun- NEW 
Word Perfect for Unix Norton Utilities 
Defragmenters & other utilities 
... many more for 386 Unix and Sun 


Mathematics 
Derive - The Mathematical Assistant 
Derive also for HP95LX Palmtop 
Mathematica -Student Edition - NEW!!! 
Mathematica Win, 386, Mac, Workstations 
MathCad for Windows GrafTool 
What's Best! Lindo 
Statgraphics Chiwriter Sci WP 


Windows Development 
(see Microsoft , Borland, Zortech, Watcom) 
ProtoView £295.00 
ProtoGen £40.00 
CASE:W £595.00 
Smalltalk/V Windows £295.00 
i £225.00 

£150.00 
£245.00 


rossDevelopment 
2500AD Cross Assemblers £129.00 
Hitech C Cross Z80, 805, 68HC11.. £395.00 
Introl C or Mod-2 Cross Comp-6809, 68K 
Aztec C68K, Avocet CCross £call 


Pascal (see Borland) 


TopSpeed Pascal SE £115.00 
Object Professional £99.00 
Btree Filer MU £115.00 
Asynch Professional £79.00 
Blaise Turbo Vision Toolkit £95.00 
Blaise Turbo Asynch Plus £120.00 
PCX Programmer's Toolkit £145.00 


Power Basic £85.00 
many Basic libraries for comms, graphics 

PC Logo - new ver 4.0 £55. 
LMI UR/Forth 
Smalltalk V/DOS £65.00 
muLISP 90 £195.00 
RM Cobol-85 (new Dev Pack) £call. 
MS DOS 5.0, £call. 
DesqView/X NEW!! £call. 


£295.00 


¢ Prices are exclusive of VAT. 

* Prices (except upgrades) include 
delivery to mailand UK. 

* Prices are subject to change. 

¢ VISA, Access and Mastercard 
welcome with telephone orders. 


Microsoft 
MS C/C++ 7.0 NEW! 
Quick C for Win 
MS Fortran 5.1 
MS Windows SDK 3.1 
MS Test for Windows NEW!! 
MS Basic Compiler 7.1 
MS Macro Assembler 6.0 


£225.00 
£99.00 
£215.00 
£195.00 
£225.00 
£225.00 
£75.00 
£99.00 
£149.00 
£60.00 
MS Quick Basic £60.00 


MS C/C++ 7.0 includes Windows 3.1 SDK 
Call for upgrades from C 5.1 and C 6.0 


Authorised Languages Dealer 


Borland 
Borland C++ & AFW new 3.0 
Borland C++ (Dos /Win) 3.0 


£295.00 
£199.00 
£85.00 
£99.00 
£52.00 
£69.00 


Turbo C++ ver 3.0 NEW!! 

Turbo Pascal 6 

Turbo Pascal 6 Prof £135.00 

Paradox Engine £225.00 
Authorised Languages Dealer 


Nu-Mega Tech. 
Bounds Checker (38 £169.00 
Soft-Ice/W ( Windows) £259.00 
Soft-Ice (for 386 DOS) £259.00 
CV/1 Code View in a Window £95.00 


Intersolv (Authorised) 
PVCS Version Control New ver £345.00 
PVCS Config Build (PolyMake) £175.00 
PVCS Networks, OS/2 & Sun £call 
PVCS Professional Editor £155.00 


MKS 
MKS Toolkit new ver 3.2 
MKS RCS & Make 
MKS Lex & Yacc new ver 3.1 


Lifeboat 
Dan Bricklin's Demo II 
Plink 86 + 
TimeSclicer 


Tools and Editors 
Brief 3.1 £189.00 
Kedit (Xedit for PC) new ver 5 £110.00 
-RTLink Plus £295.00 
Personal Rexx £99.00 
Ghost (auto software testing) £125.00 
Select Case - Yourdon or SSADM £495.00 
EasyCase Plus £315.00 
PCLint £85.00 


£149.00 
£149.00 
£175.00 


£165.00 
£245.00 
£195.00 


3-5 Cynthia St 
London N1-9JF 
Fax: 071 837 6411 


C++ & C Compilers 
also Microsoft & Borland 
Zortech C++ Dev Ed (incl OS/2) £325.00 
£175.00 
£115.00 
£175.00 
£229.00 
£275.00 
£495.00 
£265.00 
£175.00 


JPI TopSpeed C++ Pro Dev. 
Watcom C 8.5 

Watcom C/386 9.0 new 

Aztec C 86 (with ROM support) 
TopSpeed C PE 


C++ Libs 
C++/Views new ver 2 call special prices 
Zinc Win & Dos (source) new ver 3.0£299.00 
Poet (OOPS Database) £call 


C Datafile 
CodeBase 4.5 for C, C++, Win- new £195.00 
Btrieve - DOS or Windows ver £345.00 
Ctree Plus from Faircom £325.00 
Faicom Professional Toolbox £745.00 
C Communications 
Essential Comms 

Greenleaf CommLib 

C Asynch Manager (Blaise) 

C Screens 

CScape with Look & Feel 
Vermont Views 3 

Panel Plus II 

C Graphics 

Essential Graphics kernal 
PCX Programmers Toolkit 
GX Graphics 


£175.00 
£185.00 
£120.00 


£365.00 
£325.00 
£275.00 


£125.00 
£145.00 
£145.00 
£225.00 
£185.00 


C Tools Plus 
Bar Code Library- source 
... many more libraries 


£95.00 
£245.00 


Pharlap 386 DOS Ext with ASM 
Pharlap 286 DOS Ext SDK 
Pharlap 386 ASM/Link/LOC 


£325.00 
£325.00 
£775.00 


Fortran Compilers 
Lahey F77L £375.00 
Lahey F77L-EM/32 new ver 5 £695.00 
Graphoria for F77L-EM/32 £225.00 
Watcom F77 386 9 with ADS supp £495.00 
Salford FTN 77-386 £765.00 
PC/Interacter (scrns & graphics) £325.00 
Ingraf Graphics source £195.00 

Fortran Librarie: 


071 833 1022 
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How many users of your software paid for it??? 


SOFTLOoK International Limited was established in 
1987 with the introduction of our SOFTLoK and 
SOFTLoK PLUS devices to combat the ever 
increasing problem of software piracy. Our 
SOFTLoK range of software protection devices are 
used by hundreds of software developers from 
small consultancies to large multinationals. To cope 
with the ever changing needs of our customers we 
have developed SOFTLoK II which combines the 
programmable features of SOFTLoK PLUS with a 
low unit cost similar to our original SOFTLOK 
product. 


OFTLoK IF 


The Next Generation 


SOFTLoK II units are programmable devices 
containing read/write memory protected by a 
password. Both the memory and the password 
can be changed at any time using our routines 
in your application software. Easy to use menu- 
driven software is provided to allow small or 
large batches of SOFTLoK II units to be 
programmed with their initial data & passwords 
ready to be sent out with the protected software 
product. 


Price: 1-19 £1 6.90, 20-49 £15.40, As SOFTLOoK II units plug into the 
50+ £13.70 parallel printer port they can be installed 
or removed in seconds. 


Evaluation kit £20 (SOFTLoK II, manual & software) 
All prices excl. VAT and delivery 


For IBM PC, PS/2 and compatibles 

Uses parallel printer port 

Totally transparent to printer 

Secure data & password can be changed from your application software 
Cascadeable 

240 bytes of secure read/write memory 

8 byte (64 bit) password 

No programming adaptors required 

Easy to use SOFTLokK II setup software 
Routines ready to link with various compilers 
Easy to follow manual 


oooocooocoecnoao 


I-MEX House, 40 Princess Street, 
Manchester, M1 6DE, England, 
Tel: 061 228 7379 Fax: 061 236 6890 


CA functions, and you can call these direct- 
ly. In addition, there is all the C startup and 
shutdown code available (startup code 
runs prior to calling main (), shutdown 
code runs between the application exiting 


and the final return to DOS), which creates 
some useful public symbols. 


For example, the startup code defines en- 
viron, which points to a table of pointers 


GETREC.C - Returns a whole record as a 
string (or NULL if an error occurs). 


NB: Mixed language code (see MIXED.H). 
Call to malloc() is pre-processed to 
_xalloc() (5.01) or _exmgrab() (/87). 
Compile with /DCL501 for 5.01 

/DCL87 for Summer 187 or /DC for C, 


cRec := grabrec("NAMES.DBF", 6) // 5.01 
cRec = grabrec("NAMES.DBF", 6) // '87 
cRec = _grabrec("NAMES.DBF", 6) // C 


#include <mixed.h> 
#include <stdio.h> 
CLIPPER grabrec (void); 
char *_grabrec(char *, 
#ifndef c 
CLIPPER grabrec(void) { 
if (PCOUNT == 2 && ISCHAR(1) && ISNUM(2)) 
( 


// See Figure 4 


long); 


char *rec = _grabrec(_pare(1), 
_parnl(2)); 
_rete (rec) 7 
free (rec); 
} 
} 
fendif 
char *_grabrec(char *dbfname, long recnum) { 
DBFHEADER hi // DBE header 


FILE *dbf; // DBF i/o stream 
char buff(BUFSI2Z]; // DBF stream buffer 
char *rec; // Copy of record 
long recoff; // Rec, offset in DBE 


/* Open DBF file */ 

if ((db£ = fopen(dbfname, 
return NULL; 

/* Set buffer and read header */ 

setbuf (dbf, buff); 

fread((char *) &h, 1, sizeof(h), dbf); 

/* Go to start of record data */ 

if (recnum > h,lastrec || recnum <= 0) 
return NULL; 

recoff = (long) (h.dataoff 

(h.esize * (recnum - 1))) 

fseek (dbf, recoff, SBEK_SET); 

/* Grab memory and read record * 

if ((rec = malloc(h.rsize + 1)) == NULL) 
return NULL; 

fread(rec, 1, h.rsize, dbf); 

/* Tack on NULL terminator and return */ 

rec(h.rsize) = '\0'; 

felose (dbf) ; 

return (rec); 

, 
/ EOF GETREC.C 


"r")) == NULL) 


Figure 3 - 


grabrec) 


MIXED.H - Mixed language support. 
/DC : € only 

: Clipper 5.01 only 
Clipper '87 only 


/DCL501 
/DC87 


#define FALSE 0 

fidefine TRUE 1 

typedef unsigned char uchar; 

typedef unsigned int uint; 
#ifndef C // Clipper only section 
/* One-time only define’s: */ 
#ifndef CLIPPER 


define CLIPPER void pascal 


#define NULL OL 
fidefine NIL "\or 
typedef double XDOUBLE 


typedef uchar 

typedef uint 

typedef int Boolean; 
fendif // ifndef CLIPPER 
/* Data type define’s: */ 
#define UNDEF 0 


byte; 
quant; 


fidefine CHAR 1 
fidefine NUM 2 
#define LOG 4 
fidefine DATE 8 


fidefine ALIAS 16 

fidefine MPTR 32 

fidefine MEMO 65 

#define WORD 128 

fidefine ARRAY 512 

/* Parameter check macros: */ 
fidefine PCOUNT (_parinfo (0) 


define ISCHAR(n) (_parinfo(n) & CHAR 
define ISNUM(n)  (_parinfo(n) & NUM) 

#define ISLOG(n)  (_parinfo(n) & LOG) 

#define ISDATE(n) (_parinfo(n) & DATE, 
define ISMEMO(n) (_parinfo(n) & MEMO) 

#define ISBYREF(n) (_parinfo(n) & MPTR) 
#define ISARRAY(n) (_parinfo(n) & ARRAY. 
define ALENCTH(n) (_parinfa(n, 0)) 


/* Function prototypes: */ 
extern int _parinfo(int); 
char *_parc(int, 

extern int _parni(int, 
extern long _parnl (int 
extern int _parl(int, 
extern char *_pards(int, ...)7 
extern void _retni(int); 
extern void _retnl1 (long); 
extern void _retl(int); 
extern void ret (void) 

#ifdef CL501 

int _store(char far *, int, ...); 


int _storclen(char far *, int 
int “storni(int, int, 
int “stornl(long, int, 


int _stornd(XDOUBLE, int, ...)7 

int “storl(int, int, ...)s 

int “stords(char far *, int, ...); 
extern void far *_xalloc(uint size); 


extern void far *_xgrab(uint size); 
extern void _xfree(void far *block) 
extern void _xunlock (void) ; 


uchar * exmgrab(uint); 
void _exmback(uchar *, uint); 
extern uint strlen(uchar *); 
endif // ifdef CL501 
extern int _parinfa(int, uint); 
extern uint parcsiz(int, ...)7 
uint parclen(int, ...)7 
XDOUBLE _parnd(int, ...)7 
void _rete(char far *); 
void —retclen(char far *, vint) 
void _retds(char far *); 
extern void _retnd(XDOUBLE) ; 
fendif //ifndef c 
/* Memory management: */ 
#ifdef C 
#include <malloc.n> 
felif defined (CLS501) 
#define malloc (n) 
define £ree(n) 
#elif defined (CL87 
#define malloc(n) _exmgrab(n) 
/* NB: _msize() works because 
_exmgrab() calls malloc() */ 
#define free(n) _exmback(n, _msize(n)) 
fendif 
/* ,DBF header structure: */ 
typedef struct { 
char id; // Type of DBF file 
char lupdate(3]; // Date last updated 
long lastrec; // Number of records 
uint dataoff; —// Start of data 
uint rsize; // Record size 
char pad232(20]; // Align to 32 bytes 
) DBFHEADER; 
/* .DBF field structure: */ 
typedef struct { 
char fname(11]; // Field name 


xalloc(n) 


char ftype; // Field type 
char pad216(4J; // Align to 16 bytes 
union { // wither: 
uint clen; // just length 
struct ( or: 
char nlen;  // length and no. 
char ndec; // of decimals 
}) nsize; 
) length; 


char pad232(14]; // Align to 32 bytes 
} DBFFIELD; 


// BOF MIXED.H 


Figure 4 - MIXED.H, 


and include file for 


mixed language programming 


to environment strings, —_ argc, which 
contains the DOS command line parameter 
countand argv, a pointer to a table of 
pointers to DOS command line parameter 
strings. Accessing these is simple and 
doesn’t require LLIBCA. The resulting func- 
tions are illustrated in Figure 1; ge- 
tenvc() returns the count of 
environment strings, getenvv (<n>) 
returns a copy of environment string <n>, 
getargce() and getargv () similarly 
return the count and contents of the DOS 
command line. Used in combination, these 
functions will provide you with a complete 
copy of the environment table and access 
to all command line parameters from any- 
where within a Clipper application (ge- 
targv (0) returns the full 
pathname\name of the EXE program, as- 
suming you are running a twentieth century 
copy of DOS). 


If you care to turn your hand to assembler, 
you can do a lot more with the C startup 
code (the source is supplied with Microsoft 
C version 6.0), including calling code be- 
fore entering main() (in other words, 
your code is run before the Clipper code 
without you having to call Clipper yourself 
or use an EXEC loader in a COM file to load 
the EXE), The potential is also there to hook 
the other end, running your code after the 
Clipper code terminates but before return- 
ing to DOS. Figure 2 shows Assembler and 
Cstartup code to calla C initialiser function 
prior to the Clipper main () function and 
a terminator prior to returning to DOS, 


You can also use C or Assembler as a pass- 
through medium, calling an Extend func- 
tion from Clipper that in turn calls an API 
function to another product. It is possible 
to write a seamless interface to any product 
that supports a C or Assembler API, includ- 
ing NetBios, Oracle, Lotus 1-2-3, SQLBase 
and many more. 


DBF and NTX files 


The definitions of all the file structures used 
by Clipper have been published and work- 
ing with them in C is simple and effective. 
C structures can be defined to handle the 
DBF header and field definition table. Once 
initialised, the structures can be used to 
manipulate the data within the DBF file. 
Even NTX files can be modified - at least 
one third party product on the market 
utilises ultra-fast filtering by stripping refer- 
ences to records out of an NTX file. 


Records in a DBF file are stored as plain 
ASCII data. Figure 3 illustrates gra- 
brec (<filename>, <n>) ,afunction 
that returns an entire record as a character 
string in one go. 
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Multi-dialect support 


EXTEND.H contains some simple map- 
pings to allow C functions written for Sum- 
mer ’87 to be compiled for Clipper 5.01 
unchanged, but what if you need to write 
code that supports both dialects? 


Figure 4 illustrates preprocessor mappings 
to handle native C, Summer ’87 and 5.01 by 
using a simple compiler switch. 


A useful technique is to write your functions 
as native C code and then ‘wrap them up’ by 
calling them from an Extend System C func- 
tion, which is used as a call interface respon- 
sible for parsing parameters and returning 
results (grabrec () in Figure 3 is written 
like this). Splitting the code in this manner not 
only allows you to maintain native C, ’87 and 
5.01 versions concurrently, it also protects 
you from change; if you need to change 
functionality you modify just the native C 
functions, if you need to change the call inter- 
face you modify just the Extend C functions. 


Sssh! 


As is the case with many such products, 
there are things Nantucket simply didn’t 


want you to know. Having a vested inter- 
est means that I’m not going to be the one 
to tell you them, but the following are 
some general observations on Clipper In- 
ternals: 


Some third party products make heavy use 
of internals, gambling on CA supporting 
them in the future. Before you decide to 
rely on an internal you need to take an 
informed guess about CA’s future direction 
and you must be able to write a work- 
around if your guess proves wrong. There 
are no guarantees - internals, by definition, 
can be changed without warning and you 
should steer well clear of using them unless 
you have no alternative. 


Calling a Clipper function from C is 
possible, but requires the use of undo- 
cumented internals to set up and manage 
the EVAL stack correctly. There may be a 
published way of doing this in the future, 
in the mean time steer well clear. If you 
think you need to do it, look at the alterna- 
tives: products such as Codebase supply 
full implementations of the xBASE lan- 
guage in C/C++, including raw C versions 
of many powerful Clipper functions. Mem- 
ory swapping add-ons like Overlay and 


XxBASE 


DrSwitch-ASE will shell-out an application 
into expanded memory, freeing up enough 
conventional memory to let you run almost 
anything. 


Conclusion 


Just as different jobs require different 
tools, some jobs require the use of severa’ 
different tools at different stages. The 
fault of many applications languages is 
that they claim to do everything and fail 
to provide enough flexibility, restricting 
the developer to a single tool - we've al 
suffered from the ‘hammer to drive in a 
screw’ syndrome. 


Nantucket always aimed its products at the 
serious developer and recognised the need 
to provide support for other languages. The 
Extend System provides just such support - 
and it’s already built into Clipper. 


EXE! 


James Ormrod is a director of Applications 

Technology Ltd, a Nantucket Authorised 
Development and Training Centre and 
CASE and methods consultancy, ApT can 
be contacted on 0491 26060. 
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Option? 


SINGLE WIRE ZERO LOAD - Total Compatibility. 


Not available in ANY other Key product. 


~ AVERLOCK 


Option? 


Software-Only Copy Protection; economical & SECURE. 


~ EVERTRAK 


Non Copy-Protection - 


Option? 


Sole Distributor for Az-Tech Software,inc - UK, Ireland & Spain 
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The Hard ware 


wen The Soft ware 


w=: Non Copy-Protection 


Anti Hacker software protection. 


CALL FOR AFREE WORKING DEMO DISKETTE 


Other Services include:- Disk Duplication & 
supply - Label Production & supply - Packaging. 


ee, THE ONLY OPTION. 


LOOK at all OPTIONS. 


Software Protection - but which TYPE ? 
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Maite ro-S wes te: mos 
22A, Bartleet Road, 


Washford Industrial Estate, 


Redditch, Worcestershire, 
B98 ODG. England. 

Tel: 0527 510 105 
Fax: 0527 514 229 


THE 
PROGRAMMER’S 


EDITOR | 


for Windows and DOS 
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Covtente 


Ed — the one stop programming productivity tool 


¢ Supports C, C++, dBase, Clipper, Pascal etc. 

¢ Code completion 

¢ Templates for functions, statements and declarations 
¢ Error tracking for many different languages 

¢ Function/ procedure look-ups and listing 

¢ Keyboard and programmable macros 

¢ Keyboard remapping — for favourite keystrokes 


* Other emulations supplied: Brief, Qedit & Norton 
¢ Automatic indentation & formatting 

¢ File sizes up to 100MB 

¢ Unlimited undo & redo 

¢ Full Search & Replace 

¢ Line, stream & block marking 

* LAN file locking, individual configurations 


European distributor: QBS Software Limited, 10 Barley Mow Passage, Chiswick, London W4 4PH 
Tel: +44 81 994 4842 Fax: +44 81 994 3441 BBS: +44 81 747 1979 


> CIRCLE NO. 144 


UNIX 


Timed operations 


Peter Collinson looks at ways of getting UNIX to run your programs while you're not there. 


Someone was asking for some help in a 
news item recently. They had a shell script 
that was backing up an important file by 
using a cp command and copying 
precious to precious.bak. The 
copy command was wrapped in a shell 
loop terminated by a sleep command 
that waited for 3600 seconds, “This works 
fine’, they said, ‘but how do I get it to work 
exactly on the hour?’ 


‘Use at or cron’, I thought. Timed oper- 
ations are something that UNIX is good at, 
but you have to know which commands to 
use to set them running. That’s what this 
article is about. Let’s start with cron, 


The cron system 


If you run ps on your system, you will 
undoubtedly see that cron is running 
away in the background as a daemon. The 
daemon has been around since early UNIX 
days and is a big incentive to keep the 
machine running night and day. 


The original program looked in a file called 
/usr/lib/crontab for the com- 
mands to be run and the times at which to 
run them. For security reasons, the control 
file was generally accessible only by root 
and this limited the use of the system. These 
days access to cron has been opened up 
to mortals, Each user can make an individ- 
ual command file stored in somewhere like 
/usr/spool/cron/crontabs. 


Users create and maintain their own files in 
this protected directory by the use of the 
crontab command. The idea is that only 
this command can be used to change direc- 
tory contents and this makes for good se- 
curity. By the way, this command varies 
slightly from system to system, You must 
check your manual page. On my Sun, the 
command 


crontab -e 


throws you into the editor of your choice 
(it’s taken from the EDITOR environment 
variable) to create or edit your crontab 
file. The command 
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crontab -1 


will list the command file so you can 
examine its contents. 


The format of the command file 
altered much since the earliest days. Each 
line of the file contains a time specification 
and a command to be run. The format is 
simple: 


not 


min hour day month weekday cmd 

The first five fields give a time or range of 
times when the command cmd should be 
run. Each field is separated by white space. 
The field may contain an integer giving the 
time or you can specify a list of numbers 
separated by commas. The command is run 
when the time matches a value from the list. 
To save typing, ranges are shown by two 
integers separated by a hyphen. 


Finally, the field can contain an asterisk ‘*” 
that takes its usual UNIX meaning of ‘match 
anything’. You will find that you insert this 
character in most of the fields in your 
crontab file. 


To run a command at five minutes past 
every hour, you would enter 


SF BoP OL 


The minutes field runs from 0 to 59, To run 
a command at Ipm: 


0 13) & * dot: 


The hours field runs from 0 to 23, Notice 
that 


ONS Fe eer te ile 


will run the command every minute during 
the hour. To run a command on a specific 
day of each month, at a specific time: 


15 31 * * monthlystats 


runs the command monthlystats at 
3,15am the first of each month. The day of 
the month runs from 1 to 31. There is no 
way of saying ‘the last day of the month’ in 
a flexible way. Similarly, you can specify a 
particular month 


30 3 1 1 * annualstats 


runs the command at 3.30am on the first 
day of January. The final field selects a day 
of the week, You should check the coding 
of the number for your system, Some sys- 
tems use Monday=1 and Sunday=7, others 
use Sunday=0. Some allow both, for com- 
patibility. A weekend command might be 


0 9 * * 6,0 weekend.am 


runs a command at 9am on Saturdays and 
Sundays. 


The list and range formats give great power 
to select time intervals: 


0,15,30,45 8-18 * * 1-5 uchk 


runs a command, on weekdays only, every 
15 minutes starting on the hour. It commen- 
ces at 8am and finishes with a last run at 
6pm. 


Commands 


All the text on line following the time spe- 
cification is passed into the Bourne shell as 
a command. However, commands don't 
run in isolation and a UNIX process as- 
sumes several things about the world in 
which it finds itself. These days the cron 
daemon will establish a known environ- 
ment to run the commands. For example, 
cron will set up some environment vari- 
ables. On my Sun these are: HOME, the 
home directory of the user; LOGNAME and 
USER, the login name of the user; the name 
of the shell is placed in SHELL; and a PATH 
is set up. 


More interestingly, cron will establish 
stdin, stdoutand stderr. Setting stdinis easy, 
it is set to /dev/nul1 so that any reads 
from standard input will return EOF. For 
output, the daemon has a problem; it has 
no direct connection to the user but wants 
to report any errors it may find. This is 
public spirited behaviour, more authorita- 
rian systems will simply point these chan- 
nels at the great void, /dev/null. One 
way for a background process to report 
errors is to send mail to the appropriate 
user. Many systems will send mail if the 
command in the crontab outputs any- 


thing on either of the two output channels. 
The data is captured and sent in the body 
of the mail. This is useful, but it does mean 
that mail needs to be working on your 
system at all times. 


It's more common to set output files expli- 
citly using normal shell redirection oper- 
ators; since you are mostly interested in 
logging what has happened. This is often 
something like: 


00 * * * ml>>/usr/adm/ml 2>&1 


This is compressed a little to fit onto the 
page. At midnight every day, it runs a com- 
mand called m1 sending its standard output 
to a logging file /usr/adm/m1. The last 
piece of the line is a little magic that closes 
standard error (channel 2) and reopens it 
by ‘duplicating’ standard output (channel 
1). The effect is that both streams of output 
will end in the same file. 


People seem to have great faith in logging 
things to files. Systems are often established 
that write copious amounts of information 
to files and people get hooked on the idea 
that system administration consists of moni- 
toring these logs for problems. 


Icall this ‘gardening’. When gardening, you 
spend your time keeping the weeds at bay. 
This is not productive work, but it must be 
done so you can see the plants and make 
sure they are OK. Every new flower bed or 
vegetable plot creates more and more 
weeding. As time goes along, the job stops 
being productive. Weeding takes over. 
There is never any time to consider what is 
happening. The system has created a mon- 
ster: one very busy, completely non-pro- 
ductive, manual labourer, 


Avoid this. Create systems that shout only 
when things go wrong. Shouting generally 
means sending mail to interested parties. 
This must only happen when things fail. 
Never make a system send a mail message 
that says: ‘I’m OK’. People just sigh and 
weed these out of the mail box automat- 
ically, they will miss the one mail message 
that heralds an emergency. 


One trick with suppressing messages is rea- 
sonably simple and works well. The idea is 
to keep yesterday's output and compare it 
with today’s. If they differ then send mail. 
Sometimes this can mean that you have to 
be careful to remove variant text items, like 
dates or file sizes. Alternatively, you can 
preface any error messages with some 
known string, look for the string and send 
mail if it is present. All this takes a little extra 
time when setting things up, but saves 
hours and hours of useless, boring, log 
monitoring. 


The main benefit is that you will tend to 
react on the day that the first complaint 
comes. Beware that this can happen a long 
time after you have set up the system, and 
you will often have forgotten that this sys- 
tem monitoring is quietly happening for 
you. Itmight not even be you whois getting 
the message. Think about this when you 
create the message that will be sent. The 
message should contain some identifica- 
tion of its source. Remember that UNIX 
error messages are somewhat cryptic. Cre- 
ate mail templates like: 


An error has been report by 
the ml program, the output was: 


mv: g345: Cannot access: 
No such file or directory 


where the data after the hyphens is the 
actual output from the program. This does 
give you some chance of tracing the source 
of the problem while you are trying to 
remember what the m1 program actually 
does. On that topic, it’s a good idea for the 
error message to say where the shell script 
lives. This saves time too. 


As a final thought on the subject of com- 
mands being run by cron, pay some atten- 
tion to the problem of security, It's better to 
use explicit paths for commands in the 
crontab file, this ensures that only the 
program that you have put in place will be 
used. Check the file permissions on any file 
that is to be run by cron. This is needed 
especially when the command is a shell 
script. It will be running as you, and if 
someone else can put some commands into 
it, then you have no security. 


The at command 


‘he at command was invented to allow 
public spirited individuals to run their 
engthy or CPU gobbling jobs in the wee 
small hours of the night when no-one else 
would be using the machine. The job queue 
processor was originally called by cron at 
a frequency determined by the system man- 
agement. These days at and cron are one 
integrated system. You will also find a com- 
mand erroneously called bat ch that runs 
jobs in the background. I think that it’s a bit 
primitive to be graced with the name of 
batch, it does none of the things you 
would expect from a proper batch proces- 
sor. 


The at system is designed to run a single 
shell script at some time in the future. Ifyou 
want to run something in a repetitive man- 
ner then you must either use cron or make 
the’at script queue another job. It’s prob- 
ably safer to re-queue it at the start of your 
script, in case the machine dies during the 
run. 


UNIX 


If the machine has been down for some 
time, then any pending jobs will be picked 
up and run. This is one feature that makes 
at attractive. It is possible to make cron 
run a one-off job for you. Edil your ¢ron- 
tab to run the job tonight at 11pm; then 
tomorrow you just re-edit the file to remove 
the entry, Seems OK? Sadly, your job will 
not be run if someone reboots the machine 
at say 10.57pm. You missed the slot. So use 
at, when the daemon starts up it will no- 
tice that the job has been missed and will 
run it. 


Using at is simplicity itself. The generic 
form is 


$ at <time> <command> 


The time specification permits many differ- 
ent input formats and styles. Basically, just 
don’t think about it. There are some special 
words that the command understands. The 
most useful are perhaps noon and mid- 
night. 


If the command is to run in the next 24 
hours then no date is required. Otherwise 
you can give an explicit date in various 
different formats. Again, don’t think about 
it, just do what comes naturally. You can 
specify tomorrow and this is useful for 
the requeue of a job that is to run every day. 


The command argument can be the name 
of a command file. If the argument is 
omitted, then input is taken from standard 
input. This will prompt you: 

$ at midnight 

at> make nightwork 

at> *D 


and you exit with the normal end of file on 
input: control-D. If you want to embed an 
at script in a command file then a here 
document can be used: 


at noon <<% 
make pm 
% 


The job that is queued by at does not run 
in a ‘raw’ environment like the one that 
cron sets up. The at command is gener- 
ally called by a user sitting ona terminal and 
will take set-up information from the user's 
shell. It will load all the existing environ- 
ment variables into the job file, add a call to 
umask and a cd to the current working 
directory. The idea is to make the environ- 
ment the same as the one running in the 
caller's terminal session. 


This can cause problems if you are not 
careful. These are often lurking in the shell 
start-up files, like .profileor.cshrc. 
Mostly, the problems arise if lines in these 
files run programs intended to set up termi- 
nals or perhaps to interrogate the terminal 
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type for reshaping purposes. Of course, at 
has no terminal. It’s hard to deduce that the 
script is being run in at and stop those 
probe commands from being run. 


think that at is a little naughty. It should 
place something unique into the environ- 
ment so that scripts can detect that they are 
being run in its job stream, You can easily 
do this for yourself by making at into a 
private shell script: 

#!/bin/sh 

ATRUN=yes 

export ATRUN 

exec /bin/at "$@" 


Of course, you can use aliases or functions 
in your shell to create this effect without 
having a file in your private bin directory. 


Early at commands simply queued a shell 
file that was the job to be run and took the 
owner from the person who had created the 
file. The at directory was open for public 
inspection and worse, public alteration. 
This was the only way to look at your jobs, 
change them or delete them. 


The fact that the file was inspected and 
executed on behalf of the owner made for 
a good security hole. It was possible to seek 


out a writable root file (a ‘core’ file was a 
good bet at one point) and put it into the 
directory. The file could then be overwrit- 
ten with a script containing some interes- 
ting commands. When the time came, at 
would run the crack script as root for you. 
Shortly afterwards, you were superuser too, 
I certainly never felt safe to allow the super- 
user to create an at job on any of the 
machines that I controlled. 


The 4.2BSD release changed this and most 
systems have at commands that are either 
derived directly from the BSD release or at 
least owe a lot to the work that was done 
there, The main change was to write some 
header information into the command file 
and use that information to verify that the 
command file is legitimate, The clever bit 
was to make this information into shell 
comments - so the command file remains a 
shell script that can be thrown at the appro- 
priate shell. The first few lines of an at job 
on my machine looks like: 


at job 
owner: pc 
jobname: 
shell: sh 
notify by mail: 


stdin 


se fe dee 


no 


UNIX 


The BSD release also provided us with the 
atq command to look at the jobs in the 
queue and the at rm command to remove 
jobs from the queue. This means that the 
spool directory no longer has to be writable 
by mortals, The commands used to man- 
ipulate it are now privileged, eliminating 
the possibility of meddling by unwanted 
potential system crackers, 


Finally 


F you try to these commands on your sys- 
tem you may find that access to them is 
prohibited. The system manager controls a 
couple of command files that contain the 
login names of people who are regarded as 
full of integrity, or trusted, or simply permitted 
touse the commands, Alternatively, the man- 
ager can allow everyone except nominated 
horrid people to use the commands. If you're 
having no success, try bribes. 


[Exe] 


Peter Collinson is a freelance consultant 
specialising in UNIX. He can be reached 
electronically as pe@hill- 
side.co.uk (although your mailer 
might be happier to put the address the other 
way round) or by phone on 0227 761824. 
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Hardware add-ons or speci 


CopyControl be 
Floppy disks, hard disks and 
networks supported 


CopyControl is 


You can limit program use by no. of copies, 


no. of executions or date 
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Free demo disk available 


For Further Information Phone or Write to 
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Microcosm Limited, 
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Changes to source code required 


\LL bit-copier Progra 


rent to the user 


N 


Windows 3! 


File Edit Query Help 


386-PROLOG 


‘s needed 


1 


Sess OC — 


PROLOG 


Yes, 
available in a 


32-bit Prolog 


Vm 


it’s here! 
the DOS-extender version, it is a genuine 


access up to 4G (4096M) of memory. Only 
this time, it is fully integrated with the world’s 
most popular GUI: Windows 3! 


Logic Programming Associates Ltd 
Studio 4, Royal Victoria Patriotic Building 
Trinity Road, London, SW18 3SX, England 
Tel: 081 871 2016 - Fax: 081 874 0449 


LPA 386-PROLOG is now 
version for Windows! Just like 


compiler which can directly 
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When you look inside... 


You'll see that it's a real 
pearl of an idea. 


We think you should know exactly what you're friendly utilities make it a snap to develop the 
buying. That's why we've made sure you can look scheme that's just right for your product. And 
inside DeadLock 3. DeadLock 3 is so secure, we're even 

DeadLock 3 gives you the best software 
protection available. Our unique 
combination of custom-designed ASIC 
and proven mathematical algorithm lets 
us safeguard your product without hiding 
anything. And that means you stay in 
complete control. DeadLock 3 protection 
is dead easy to implement too. Our user- 


ready to give you the complete sources*. 
Contact us today and find out about 

DeadLock 3. We've got a demo kit 

waiting for you - complete with utilities, 

samples and full documentation. There's 

absolutely no obligation. We just want 

~ you to look inside and see what a pearl 


of an idea it is. 
aawelilcnika @a™ .: c 
Decelloe}e 8” is real protection 


BL Computer Security Limited 
101 Hendon Lane, Finchley, London N3 3SH 
PO Box 2543, London N3 3UA, United Kingdom 
Fax: 081 346 2672 Tel: 081 343 0734 


CREATIVE COMMUNICATIONS. 


*Sources available in compliance with terms specified by the manufacturer 


> CIRCLE NO. 145 


Books 


Third Generation Windows Programming plus C’s New Testament. 


In the Ganglands 


These technical writing gangs that wander 

the streets of California have me a little wor- 
ried. What happens if one of the Waite Group 
falls in love with one of the Coriolis Group? 
Do they get thrown out for disobedience, or 
do they take poison, or is itsorted outin a mass 
street-fight or what? 
Windows Graphics Programming with Bor- 
land C++ is written by the definitively singular 
Loren Heiny, who co-wrote Power Graphics Using Turbo C++ with the 
Coriolis bunch six or seven compiler-generations back, and still pub- 
ishes under their auspices. The new one-man team format works 
wonders; for instance, you now only need one lifetime to read the 
thing. Its 500 pages cover more topics than I've seen other Wiley 
proth-cooks handle in 1,500, And with a whole book to write, Loren 
isn’t scared to concentrate on three or four major projects rather than 
thousands of itty-bitty examples. As he explains, ‘too many issues 
never seem to crop up in small programs. Only by attempting full- 
blown applications do you really begin to understand the important 
trade-offs in Windows graphics programming’. Well, exactly. Admit- 
tedly, when faced with a listing over 45 pages of C++ code long (2000 
plus lines) the reader's heart does flutter momentarily, but the listings 
are well-documented and worth-reading - and as born and bred C++, 
they also include some highly reusable classes. I have my eye on Heiny’s 
TBarGraph class (with descendants that cope with symbol and 3D 
charts) and a pre-potted tool bar routine from page 278. 

The range of the book is pretty exhaustive stroke exhausting. I was 
expecting a nod to 3D graphics under Windows - Heiny provides a 
complete class for creating and viewing 3D wire-frame objects, And 
then he adds a daughter class for solid objects, with hidden surfaces 
removed using the Binary Space Partitioning algorithm. He also covers 
animation under Windows through blitting and palette-manipulation, 
writes on object-oriented drawing (including a full MacDraw-alike 
application), toys with the full 256-colour palette, messes around with 
fractal landscapes, and then swaggers breezily into texts, fonts, and 
bitmap handling. No knowledge of the GDI to any extent is assumed 
- although you'll need a ken of C++ syntax and objectives. You will need 
OWL - Borland’s Windows class library - though: use this book on any 
other brand of compiler and it will certainly explode in your face. 

There are a few gravelly bits. There’s a sticker marked ‘Windows 
V3.1 compatible’ slapped hurriedly on the cover, but there's no men- 
tion of the new fonting technology, although I think I’m right in 
assuming no large programming issues arise with TrueType. It’s not 
quiteas good as Petzold at pointing out the trade-offs of using different 
drawing techniques, although its structure is more logical and less 
oriented to Windows internals. And despite the use of some intriguing 
algorithms in the later 3D chapters, Heiny neglects to include a bibli- 
ography, which grates. And you have to send off to some godforsaken 
place like Arizona or Utah or Canada or somewhere for the disks. I 
wish these publishers would get some form of local distribution sorted. 
Otherwise, top-hole. 


Books 


Title: Windows Graphics Programming with Borland C++ 
Price: £26.95 Author: Loren Heiny 
Pages: 474 Publisher: Wiley 
ISBN; 0-471-54891-X 

[iene reer eH 


“ANSI and 180 


STANDARD) C 


Progrommer’s Relerence 


Rail-Roading C 


Kernigan and Ritchie's C Programming Lan- 
guage has been deemed the C Programmer's 
Bible. However it is best described as a tutorial 
on good C programming style, For a detailed 
specification of the language, this month I have 
been looking at ‘an authority’ on ANSI C, name- 
ly ANSI and ISO Standard Cby P J Plauger and 
J Brodie. The flavour of the language it de- 
scribes was developed by ANSI’s X3J11 committee and the standard 
corresponds to ANSI X3.159-1989 (which is equivalent to ISO/IEC 
9899:1990). 

Standard Cis divided into two sections. The first looks at the syntax and 
semantics of ANSI C. There are eight chapters, including sections on 
Declarations, Functions and Expressions. Instead of subjecting the reader 
to the terseness of BNF to describe the language, Standard Chas opted 
for a ‘pretty’ representation which the authors describe as ‘railroad track’ 
diagrams. These consist of boxes, containing elements that make a given 
language construct, and arrows which show how the boxes can be 
connected, This diagrammatic representation has a more immediate im- 
pact than BNF and conveys the same information using far ace, 

The rest of the book covers the Standard C run-time library. This 
begins with an introductory chapter which looks at program Star- 
tup/Termination, File I/O streams and a section on formatted I/O 
which givesa number of print f and scanf examples. The remain- 
ing chapters look at the standard header files. Each outlines what 
functionality the header file provides together with a description of its 
macros and function prototypes, including information on what the 
parameters mean and return code values. 

The authors have thoughtfully provided a useful appendix on writ- 
ing portable code. For source code compatibility, the book recom- 
mends such measures as creating a single data object no larger that 32 
KB and using variable names which are distinct in the first 31 charac- 
ters. Run-time issues are also covered, including inconsistencies with 
the internal representation of data structures or floating point variables. 

ANSI and ISO Standard C gives the reader a guide for writing 
ANSI-compliant C code. Thanks to the ‘rail-road’ diagrams, the syntax 
and semantics of the language are easy to follow. There isn’t enough 
example code to make this book a replacement for your C run-time 
library reference, However in the DOS market, neither Borland nor 
Microsoft has produced an ANSI-compliant C compiler which means 
that a programmer must look elsewhere for a reference on ANSI C. I 
am sure that ANSI and ISO Standard C will find a place on the 
bookshelves of those programmers writing the ANSTest C code. 


Pa cate wrk Fo tr 


Title: ANSI and ISO Standard C 
Publisher: Microsoft Press 


Pages: 278 
Author: P J Plauger and J Brodie 


Dan O'Brien, | Price: £14.95 ISBN; 1-55615-359-7 
Books Received This Month 
Object Oriented Databases. P Gray, K Kulkarni, 
N Paton Prentice Hall £19.95 ISBN: 13-630203-3 pp237 
Advanced Windows Programming M Heller John Wiley £25.50 ISBN: 0-471-54711-5 pp353 
68000 Assembly Language 
Programming and Interface A Barry Prentice Hall £57.05 ISBN: 0-13-805680-3 pp377 
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At ARM’s length 


Mike Banaban discovers a new IBM compiler which shows up the limitations of Gfront itself. 


So what’s new this month? Lots of con- 
ferences coming up (or gone by the time 
we get to print), among them the C++ user 
debates held alongside the Object Expo 
conference in London, Entry to the debate 
is free to members of the ECUG, so we'll 
hope to see you there on the 14th and 16th 
of July. 


1 was fortunate enough recently to be 
able to play with a pre-release copy of 
IBM’s new C++ compiler. At first glance it 
seems very impressive: I got as far as trying 
out its template handling, but didn’t find out 
that itsupports exception handling too until 
after the event. I still don’t have any proof 
that it doesdo exception handling, but keep 
hearing people say that it does. We're trying 
to get hold of our own copy as I write. 


It’s the first compiler I've tried which 
really does go to lengths to implement the 
ARM, the whole ARM and nothing but the 
ARM. Some of the impact on function over- 
load resolution will surprise old-timers who 
think that what Cfront does is what the ARM 
defines: at times the surprises are nasty. 
Here is one of the shocks you get when you 
really stick to the rules: 


class has_ar{ 
public: 
int operator[] 
(unsigned int); 
operator char *(); 
yi 


main() { 
has_ar anobj; 


cout << anobj(1]; 
} 


What would you expect to happen in the 
output statement? The geriatric brigade (ie 
those who’ve used C++ for more than a 
year) will expect the constant 1 to promote 
up to unsigned int, then be used in 
has_ar: :operator[] () - go on, 
admit it, so did you. 


But, refer to the ARM, section 13.2 on 
argument matching ‘...the intersection of 
the sets of functions that best-match on 


each argument... Let’s go through it. 


The set of functions which best-matches 
the first argument is easy: anob j is of type 
has_ar, so it is an exact match for the 
implicit first argument of 


YL eeeeeeeeeeeeceeedeeedeeeeeedddeddededdeddéedddddda 


The DOS world is 
going to end up 
building a lot of 

C++ software 
which would 
benefit from the 
stricter checking 


SL eeedeeeeeeeeeddeeeeeeeeeeddedeededeedddeedededdddedddda 


has_ar::operator[] (unsigned 
int) . Nothing else is in the set. 


The set of best-matching second argu- 
ments is not quite as obvious. If you apply 
the char * conversion, you discover a 
perfect match: the built-in operator [] 
(int) for char *. This is the only func- 
tion in the second set. 


Now form the intersection of the two 
sets: it's empty, so the call is erroneous! I 
was so surprised by the result that I spent a 
week corresponding with the compiler de- 
velopment team in Toronto, but after vari- 
ous bits of email bounced back and forth, I 
found it hard to argue with them. Wow! 


Here’s another one I didn’t expect 


class has_conv { 
public: 
operator int(); 


main() { 
has_conv hcobj; 


cout << hcobj; 
} 


Do you expect the compiler to convert 
hcob}j to int and then output it? I did. 
The screen filled with warnings about am- 
biguous function calls. ARM, section 13.2, 
(page 236 in the version I have) ‘If user- 
defined coercions are needed for an argu- 
ment, no account is taken of any standard 
conversions that mightalso be involved’, So 
the compiler does indeed convert hcob j 
to int, but then finds that there are con- 
versions from int to char, short, 
long, float, double, long double 
and various unsigned bits of crud. Result? 
Every one of them is ambiguous. 


Speaking as someone who makes a liv- 
ing from consultancy, I just can’t wait to see 
what happens when the bulk of existing 
C++ code gets shoved through a compiler 
as tight as the IBM one. I’m going to have 
extra-deep pockets added to that suit right 
now... 


None of the other compilers I have used 
comes anywhere near this degree of con- 
formance to the ARM, and I’ve tried a lot of 
them. Apparently the compiler will only be 
available on the RS6000 UNIX machine for 
the time being, which is a pity, because the 
OS world is going to end up building a lot 
of software which would benefit from the 
stricter checking. Perhaps it will be a spur 
to the other suppliers; although judging 
from the limited chance that I have had to 
try out that compiler, it’s a tough act to 
ollow. There may be problems with it, 
but neither I nor the students I was teach- 
ing found any; and in my experience a 
group of keen students finds problems 
that most company’s test suites don’t 
come near, 


The worst of it is that I can’t use my joke 
answer any more: 


Q- ‘Which is the best C++ compiler?’ 


A- ‘There aren't any.’ 


Mike Banaban is Chairman of ECUG. For 
more information about ECUG, call 071 
253 5121. 
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Comms Programmers 


Do you spend 90% of your time debugging low-level datacomms software and 


only 10% on your real application ? 
Ihe PPU™ Programmable Protocol Converter is 


your ready-to-use stand-alone comms platform, 


With its fully-integrated internal ultra-fast standard 
PASCAL compiler with comms extensions, internal 
WS-compatible editor and filing system, program 
‘security for VARs, and many other features, you can 
be building your own self-contained stand-alone 
high-performance datacomms product in minutes. 


2 or 4 serial ports with all handshakes, modem control, baud rates to 115200. Real-time clock, non-volatile 
data storage, etc. All VO uses high-level READs & WRITEs. Up to approx 1000 lines of PASCAL ~ compiles 
in seconds. Also has a BASIC interpreter. No microprocessor hardware knowledge or assembler required, 

Options include 16-bit analog /0. C cross-development possible. All you need is an ANSI terminal or a PC. 


Terminal emulator program (DOS/Win 3) with PC-PPC file transfer included. Solid high-quality product in an 
attractive RFI shielded metal case. Made in UK by KK Systems Ltd. Available ex-stock. Prices from £299. 


KK Systems Limited 36 Mill Hill Drive Shoreham Sussex BN43 5TL 
® 0273-452357 fax 0273-440535 
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COMM-DRV-Professional Serial 
Communication libraries $89.95 US. 


COMM-LOG-True background XMODEM/ 
YMODEM file transfer tool $89.95. 


MTASK-True preemptive multitasking 
kernel for MS-DOS $89.95. 


SCRN-INPUT-Character screen 
management package 


TEL 713-498-4832 

FAX 713-568-3334 

ADDRESS: Willies Computer Software Co. 
2470 S. Dairy Ashford Ste 188. 
Houston, TX 77077 


$89.95, 
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Programmer 
and Proud 
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You'll be glad to know you're 
not alone. 
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every two months, is what every 
serious Basic User has been 
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Programmers 
required 


A succosstul software house requires top quality PC pro: 
‘grammors to work on a graphics rolated Windows application. 


Applicants must have a proven understanding of C and 
Windows but also be complotaly compotent in 386/486 
assombior, as thero are speed critical areas of code. 

‘You would bo joining a group of young, enthusiastic program- 
‘mors producing a main stream application and become part 
‘of a small (a dozon programmers) but successful and 
‘growing software house, 

Computor Concopts has boon producing softwara for 10 
yoars and is based in a large mansion in the Hertfordshire 
Countryside. Faciltios include tennis, snooker, swimming pool 
‘otc. Starting salary rolated to experiance, but regularly 
roviowod 80 the right parson has the opportunity for high 
rowards. 

Assistance with accommodation possible. 


CV to Charles Moir at; (=) 


Computer Concepts Ltd 
Gaddesden Place, HemetHompstead, Hots HP2 6EX 
Tel 0442 63933 Fax 0442 231632 
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The Secret.of Successful 


Advertising is... 


To find out how you can reach 17,000 


professional developers for as little as 
£85, call Marc Warren on 081 994 6477 


Basic Magazine is published by 
Process Communications Ltd, 10 
Barley Mow Passage, Chiswick, 
London W4 4PH 


PC Data 
Security Guide 


Data Protection and Security 
for Personal Computers isa 
guide for support staff and 
managers. Everything you need 
to know about: 


e Keeping viruses out of your 
company. 


Drafting and implementing 
acorporate data security 
policy. 


Persuading staff to take 
regular backups that are 
known to be reliable. 


Detecting and eradicating 
software piracy. 


Includes comprehensive 
product guide and lots of 
trouble-shooting advice. 


The price of £145 includes 90 
days’ free telephone support 
from the author, 


Please call TTK Technical 
Publications on 081 995 9845 
for details and a free brochure. 


To advertise in this section, please call Marc Warren on 081-994 6477. Fax 081-994 1533 


C++ Modeling 
& Simulation 


Class Library 
Object Ortented Technology for Engineering, 
Manufacturing, Finance, Education 


Meijin++' 2.0 


«Integration & Approximation 
 Semi-Persistent Containers 
«Discrete Event Simulation 
«Numerical Analysis 
+ Queuing Systems 

» Exceptions 

Statistics 


Network Integrated Services, Inc. 
Tok: +1-714-755-0006 


COMPUTERS 
COMPUTER PARTS 


PLOT THE 
DIFFERENCE 


PLOTVIEW 
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=, Phone now for mor 


the versatile too! thi 
to your productivity. 


CAMEL SERVICES LTD. 
Telephone OXFORD (0865) 512678. 


about PLOTVIEW: 
really make adifference 


Fonts & PostScript 


PostScript Interpreters: from £4 to £4,000 
Fountain, GoScript, Freedom of Press, 
Ultrascript, PS Tutor, LincPage, NTG2000 


PostScript LaserJet Upgrades from £239: Adobe, 
HIP, Pacific Page, UDP TurboScript HP/Canon 


PostScript Utilities: ATM, PSFx, PSPlot, Books 


Type 1 Fonts from £3 to £3,000: Public Domain, 
Adobe, ZSolt, Digi-Duit!, Watland Orb 


HP Bitmap Fonts: ZSoft, Typografica, Digi-Duit!, 
Atech, DTS, Watland Orb, Tailor Made 


Laser Printer Memory Upgrades: HP, Canon, IBM 
Custom Fonts & Logos: most formats available 
Custom HP Font Cartridges: from £90 (10 off) 


Orchid °486 & Video 


Motherboard + Fahrenheit 1280: runs up to 
18 times faster than standard VGA: £960 
Complete systems from £2469 with NEC 4FG 
David Pollard Associates 
Folly, Bridge Workshops, Thames Street, 
Oxford OX1 1SU 0865 240048 Fax 792277 


Database reports made easy 
for dBase, Clipper and 
compatibles. Also for Paradox, 
123s and Quattro Pro. 


Turn raw data into useful 
information using Lotus like 
commands and menus. 


Available from 

QBS Software Ltd 

10 Barley Mow Passage 
London W4 4PH 

Tel: 081 994 4842 

Fax: 081 994 3441 


Call for free demo disk 


Comguter 
MUS C systems Ltd 


HIRE INFORMATION TECHNOLOGY PLC 


H/l R/E 


GUARANTEED VIRUS FREE 

Hire IT, is the ONLY PC Rental company that can Guarantee all systems are 
delivered Virus Free and stay that way throughout the hire, because Hire I.T. is 
the only PC rental company to load Anti-Virus software on every system we ship. 
FOR COMPLETE PROTECTION FROM VIRUSES 
ONLY RENT FROM HIRE I.T. 


071 490 1515 


S463. CMT Y oR 
LONDON EC1Y 


5-7 Buck Street, 
London NW1 8N)J. 
071-482 5224 


my Voyetra Sound Factory™ 


Sound Factory™ is a complete audio development kit for 
DOS or Windows 3, from Voyetra, the leaders in IBM 
music software. Containing drivers for a wide range of 
sound cards, digital audio boards & MIDI interfaces, 
Sound Factory™ gives developers as wide a market 

as possible. Call or fax us for further details. 


We also stock a wide range of PC software and peripherals. 
Specialists in Music Software 


Object 
Oriented 
Real 


Time 
Kernel 
for 
Turbo Pascal 
Now Available 
from 
JPS Graphics 
For more 
information call 


0244 821009 


(elephone or Fax) 


JPS Graphics,-3 Glynne Street, 
Queensferry, DEESIDE, CHS 1TA 


WORKSTATION MEMORY 
SUN 4 COMPATABLE MEMORY 
4/20/SCL 4Mb £200 
SPARCSTATION ELC 4Mb — £200.00 
16Mb £675 
4/40 (IPC) 8ONS IMb — £44,00 
TONS IMb £48.00 
80NS 4Mb £165.00 
7ONS 4Mb £184.00 
SPARCSTATION IPX 4Mb £200.00 
16Mb £675.00 
4/60 SPARCSTATION 1 IMb £44.00 
4Mb — £165.00 
4/65 SPARCSTATION 1+1Mb £44.00 
4Mb £165.00 
4/75 SPARCSTATION 2 4Mb £165.00 
4/110,150 IMb £44.00 
4/260,280 8Mb £1870.00 
16Mb £2300.00 
32Mb £3995.00 
4/330 8Mb £740.00 
16Mb £1205.00 
32Mb £2250.00 
64Mb £4140.00 
4/370,390 4Mb £165.00 
4/470,490 32Mb — £POA 
128Mb_ £POA 
SUN 3 COMPITABLE MEMORY 
3/50, 3/52 4Mb — £475.00 
8Mb £765.00 
4MB_ £305.00 
SMM TOOL KIT £35,00 
3/60 IMb £44.00 
3/80 IMb £44.00 
3/75,110,140,150,160,180 
4Mb — £750.00 
8Mb £975.00 
12Mb £1300.00 
16Mb £1620.00 
20Mb £1950.00 
24Mb £2275.00 
3/260,280,470,480 8Mb £1870.00 
16Mb £2300.00 
32Mb £3885,00 
3E120 4Mb — £505.00 
8Mb £785.00 
12Mb 1075.00 
SUN 386 WORKSTATION MEMORY 
386i,150 IMb £44.00 
3861,150x,250 IMb £44.00 
APOLLO DN MODELS 
DN2500  8ONS IMb £44.00 
70NS IMb £48.00 
DN3000, DN3010 2Mb £280.00 
DN3010A,3040,3500,3550,4000,4500,5500 
4Mb £370.00 
8Mb . £630.00 
HP 400 SERIES 
HP9000/400,400d1,4001,425t,4005,433s 
4Mb £345.00 
8MB £740.00 
16Mb £1335.00 
32Mb £2540.00 
HP APOLLO 9000/425E 
4Mb £355.00 
8Mb £725.00 
16Mb £1200.00 
HP APOLLO 900/700 
8Mb £990.00 
16Mb £1485.00 


32Mb £3940.00 
IBM COMPATIBLE MEMORY RS6000 
RS/320/320H,520,530,550,730,930,950 
16Mb £1250.00 
32Mb £2290.00 
64Mb £4390.00 
APPLE COMPATABLE MEMORY 
Mac IL,IIx,Iex. 1Mb £42.00 
SE,SE/30,PLUS,CLASSIC, 
LC Ici, IIsi 4Mb = £170.00 
Mac IIfx 4Mb — £200.00 
16Mb £825.00 
SILICON GRAPHICS COMPATIBLE 
PERSONAL IRIS 4D/20,25 
1Mb £44.00 
4Mb = £165.00 
PROFESSIONAL IRIS 4D/S0,70,80,85 
1Mb £44.00 
4Mb = £165.00 
POWER SERIES 4D/120,210,220,240,280, 
310,320,340,380 2Mb = £135.00 
NEXT COMPATIBLE MEMORY 
NEXTcube,NEXTstation 1Mb £42.00 
4Mb £170.00 


SABREBANNER 
Tel 0532 854521 


VISA, Access & MasterCard Taken 
Fax 0532 853026 
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Using enums 


Francis Glassborow continues his discussion of constants with enums, and also has a few choice words for [pfnAboutDigProc. 


C programmers use #de fine for two dis- 
tinct c s of constants; those that are simple 
manifest constants and those that are compila- 
tion constants. They also use #de f ine to con- 
trol the process of compilation via #ifdef 
directives, but these can be distinguished from 
the other uses because they do not require a 
completing value. 

The const keyword that I wrote about last 
time can only be used for run-time constants, as 
C requires that the size of an array is known at 
compile time. As C treats const as read-only 
variables they cannot be used to specify compile 
time values, The very weakness of #de fined 
values becomes a strength in this situation - the 
pre-processor makes the substitution before the 
compiler sees your source. 

As well as misappropriating the const key- 
word from C++, C also stole and abused the 
enum keyword. In C++ enums are genuine 
user-defined types - but not so in C. In ISO C they 
are merely a convenient way of creating manifest 
constants of an integer type. Declaring a variable 
to be of a particular enum type actually leaves 
you knowing less about it than you would if you 
declared it as one of the integer types. All the 


Standard requires is thatan enum be compatible Hungarian Notation 
with some type that promotes to int. 


In my opinion enuns in C are pretty useless Many programmers recently s to have 
objects and have very little to offer. They create | come across this method of identif ing the type 
an illusion of a type without providing much | ofa variable in its name. Leaving aside my dislike 
beneficial substance. As they behave in all ways | of naming conventions that add typing and ob- 
like #defines of integer type they might as | scure simple names, there are other problems 
well be used as such, You can use your enum | with such conventions. Good type checking by 
tags in array declarations and in the case | your compiler sorts out most problems (unless 
clauses of a switch statement. They have few | you are one of those macho programmers that 
advantages over the more traditional approach, | switch off all warnings). 

In some circumstances they produce more read- The major problem with adopting Hungarian 
able code in yourheader files, and used sensibly, | Notation is that it simply does not make any 
they can make other parts of your source eas sense in a full object-oriented environment with 
to follow. For example, the traditional: unlimited user defined types equal (well almost) 
in status to the base types. If you expect to move 


waeeane black ¢ towards C++, I suggest you think very carefully 

#define green 2 about appropriate naming conventions. 

fdefine blue 4 Iwouldbe delighted tohear your opinions about 
becomes: any of the topics covered in this or earlier columns. 


enum colour 
{black, red, green, blue=4}; 


C++ and Pascal programmers will be horrified 
by the emasculated (is that a PC term?) nature of CUG(UR) write to Francis Glassborow at 64 South- 
the C enum, field Road, Oxford, OX4 LPA or ring 0865 246490. 


JUL Y. EXEWORD : 14 Chip moving east but stuck in 


hard water (3-5) 
15 Observe container of agent with broken processor (3,3) 
17 Set into anon-binary condition (6) 
19 In recent years gate can be lovely (8) 
23 Circular function (5) 
25 Where underground programmers work (9) 
26 It averages half a disc revolution (7) 
27 Anonymous label (7) 
28 Magic code word that used to make things work (11) 
29 — Beginning of style where some programmers are? (3) 
DOWN 
Neither one thing nor the other? (9,2) 
Go with 1 across - so twee (7) 
Act like God, maybe, when using Forth (4,5) 


1 
2 
3 
4 — Sub-editions of a program (8 
5 
6 
if 


Invisible network gateway (6 Ti 
Go in for a major key (5) Y H 
Material of a neural compute tiv 
(7) c G 
8 — Report when you do go wrol = 
(3) 7 
13 Without doubt giving EE 
something D Cale 
the systems can evaluate? ( w N 
ACROSS 16 Determination to settheworlo |v] e;ais|tlele le 
1 It's before you now, ready to go (3) alight (9) i P N | a x 
3 Relocatable chunk of program without fixed morals (7,4) 18 Itkeeps ticking away,ina Foy Tel el mle = 
9 Usefull aplicasion! (7 loop maybe (7) = ue 
10 Somehow get in - er - unreal type ... (7) 20 DONOT-puton | ! |_| z ie 
11... that’s howling sadly (9) Sen AEB LE Le 2 CH Ae NE eta a 
12 — Set of peaks set for an input (5) Guedly) i i ‘i’ ie f |_| ‘im 
“EXEWORD’ compiled by a Makes unfeeling eg when 14 = [ratio fale e [xe] uf efFls| 
Eric Deeson JUNE .EXEWORD 
.EXE Magazine, Vol 7, Issue 2, July 1992 
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-EXE RECRUITMENT - Please call us on 081 994 6477 to book your advertisement 


QUESTOR 


Computer Personnel 


ORACLE PROGRAMMERS 
CAMBRIDGE to £19K 
Systems house providing applications to the international 
pharmaceutical industry, require programmers with solid dev" 
experience in an RDBMS, preferably ORACLE, under UNIX 
or VMS. Contact A.H 


SYSTEMS DESIGNER 
S.HERTS to £24K 
Essential requirements include sound exp’ of low level h’ ware 
& s’ware design & dev’ in C & 808x assembler, & in-depth 
knowledge of image processing/line scan technology. Some 
USA travel. Contact P.H 


SENIOR ‘C’ PROGRAMMER 
MILTON KEYNES £Neg 
With about 4-5 years sound software engineering experience 
in C, probably in a DOS environment, you will be self 
motivated and enjoy working in a small technical and 
challenging environment. Contact P.H 


PROGRAMMERS 
S.HERTS to £18K 
Prestigious developer of graphics s’ware require two 
additional Graduates with 12 mths C++ or C/UNIX. Bright self 
starters to work in small teams on innovative product. 
Contact A.H 


SYS’/ANALYST DESIGNER 
MILTON KEYNES £Neg 
With a realtime s’ware engineering background to work with 
clients & systems developers to transcribe requirements into 
full functional spec’s & implementation plans. Understanding 
of development to firmware level is necessary. Proven project 
exp’ & analyst skills. Contact P.H 


INTERNAL CONSULTANT 
BEDFORD to £30K 
Expanding software developer with niche market require 
‘GURU’ with C/UNIX skills to develop applications and 
interface software and act as consultant to project leaders and 
development staff with 4GL background, as the company 
moves towards C, Contact P.H 


N.HERTS PROGRAMMERS to £14K 


Highly regarded client requires 2 additional programmers with 
6-18 mths exp’ of 4GL, C or Pascal in PC or OS/2 environment. 
Must be well presented with potential to rise within the 
company. Contact P.H 


PROGRAMMERS 

CAMBRIDGE & HERTS £13-20K 
Two programmers to work on applications dev’ within 
established s’ware company. Graduate candidates, with 
upwards of sandwich placement exp’ of databases 4GL 
applications dBase/Clipper should send a CV immediately. 
Contact P.H 


HERTS PROJECT MANAGER £Neg 


Very successful s’ware company, need a PM to lead several 
simultaneous projects in commercial sector. Good 
organisation skills essential, knowledge of CASE tools, and a 
background in applications development useful. Contact P.H 


Write with, or FAX your CV to: 

QUESTOR COMPUTER PERSONNEL 
REGAL HOUSE, TEL: 0462 438373 
55 BANCROFT, FAX: 0462 421272 
HITCHIN SG5 LLL EVE: 0462 459338 


Qcp 


WEST 
YORKSHIRE 


CLIPPER ANALYST PROGRAMMER to work in 
a dynamic & friendly environment under- 
taking new development work. Knowledge 
of ‘C’ an advantage Salary to £16,000 


We currently have avery wide range of UNIX 
based vacancies for INGRES & COBOL 
under UNIX including project leaders, 
analyst programmers, pre/post sales 
support and systems admin. 


For your next career move around 
West Yorkshire, telephone 
Vincent Atherton on 
Leeds (0532) 504560 or write to: 


AIREDALE RECRUITMENT 
Realtex House, Micklefield 
Lane, Rawdon, Leeds LS19 6AX 


ATREDALE 
RECRUITMENT 


1-3 years experience? 


Looking for your first move? 


ViSiON can help. 


Whatever your experience we probably have 
the new opportunity you are seeking. We have 
in-depth knowledge of the computer industry 
with an extensive client base that ranges from 
small ‘start-up’ companies to multi-national 
consultancies. Work is at the forefront of the 
industry offering career potential to more than 
match your individual ambitions. 


Our Professional advice is free so if you are 
looking for that first move..... Give us a call 
What have you got to lose? 


ViSiON Computer Recruitment Ltd. 
70A High Street, Stony Stratford, 
Milton Keynes, MK11 1AH 
Telephone: (0908) 260910 


RONICOM 


RECRUITMENT 


1 Golden Square, London W1R 3AB 
Tel: 071-734 8434 Fax: 071-734 8379 


Software Engineer from £20k 
This major consultancy is seeking a professional de- 
veloper with experience of ‘C’, C++ (with 
Glockenspiel preferably) and solid experience in the 
SNA connectivity and communications sector. If you 
have this experience under MS-Windows or X-Win- 
dows it would really give you an advantage. 
Experience on OS/2 and Networking platforms would 
also not go amiss. 


Junior Programmer to £20k 
An exciting opportunity has arisen with one of the 
leading compiler manufacturers to join their highly 
professional development team on a new project. 
They are seeking a graduate (pref. 1st class) with 1 
to 2 years level such as compiler development. Long 
term future with stock options after promotion are on 
offer. 


Senior Analyst/Programmer to £25k 
This highly computerised end-user, one of a small 
number doing all their development under MS-Win- 
dows, is recruiting a Senior A/P who has experience 
in Windows either with 'C’ or Visual Basic. Addition- 
ally, experience of mainframe connectivity and/or 
other Microsoft products would be a distinct advant- 
age but above all they are looking for somebody with 
a flexible approach to their work. 


Technical Support, Thames Valley £20k to £30k 
This well known Software developer is looking for ex- 
perienced Database applications developer with a 
good client manner for support and consultancy. work. 
‘C’ under MS-Windows essential as is a good knowl- 
edge of any leading DBMS with experience on at 
least two operating platforms. Experience of training 
would be a distinct advantage as would previous pro- 
duct demonstration experience. Additional benefits 
include stock options, so prepare to be committed for 
life. 


Programmer SQL/C/Oracle, Home Counties £20k 
This small but very dynamic and specialist software 
house is seeking an individual willing to be their ‘Fri- 
day’, in return for which they will train you to assist 
them in their consultancy work. This company is re- 
ally looking for a ‘people literate’ programming boffin 
who wants to emerge from behind the screen. 


Analyst/Programmer, SQL-Windows £22k 
This highly specialist consultancy is looking for a de- 
veloper with experience of SQL-Windows. Although 
this is an A/P position at the present time progression 
into their consultancy division is envisaged for the 
tight sort of person. 


IF ANY OF THESE POSITIONS ARE AT ALL SUIT- 
ABLE, OR EVEN IF YOUR SKILLS ARE NOT 
QUITE WHAT IS REQUIRED, DO NOT HESITATE 
TO CONTACT ROB ON 071-734 8434 OR AFTER 
HOURS ON 081-767 1003. LOOK FOR REGULAR 
UPDATES ON ORACLE TELETEXT. 


ASH ASSOCIATES 


We specialise in the Recruitment of Software and Hardware Design 
Engineers for Real Time Applications including Graphics, 
Communications, Control/Robotics, Signal/Image Processing & 
Modelling, Real Time Financial Systems/Databases. 


LATEST C & WINDOWS OPPORTUNITIES 


SE LONDON: Team Leader, Image Processing/Control Systems £20K+ 
SW LONDON: Senior Engineer, Control/Data Acquisition Systems £20K+ 
SW HANTS: Senior Engineer, User Interface Design/Graphics £20K-£25K 
W HANTS: Prj Managers, Instrumentation, Subsea Systems  £25K+Car 
NE SURREY: All levels, Interactive Video, Graphics Systems £12K-£25K 


WE HAVE REAL OPPORTUNITIES FOR ENGINEERS WITH 
ANY OF THE FOLLOWING SKILLS 


C & CH WINDOWS UNIX KERNELS 
INTEUIMOTOROLA ASSEMBLERS] © [GRAPHICS] — [OSF/MOTIF 
SIGNAL PROCESSING]|IMAGE PROCESSING][CONTROL SYSTEMS| 
08/2] [DATABASES]  [TELECOMMUNICATIONS] —[ MALPAS 
YOURDON)]| 885750 || RISC PROCESSING |[TRANSPUTERS] | VIDEO 


For these and similar opportunities, call James Hunt or Ron Cook NOW! 
Tel: (0425) 475480 Fax: (0425) 480807 


associates 


RECRUITMENT CONSULTANTS 
3 Piper's Ash, Ringwood, Hants, BH24 1UF 


SOFTWARE DEVELOPERS 


BERKS £18k - £24k 
Development and support of EIS object-oriented 4GL applications using GUI's 
data manipulation and distributed data source connections (SQL, DDE, ASCII). 
You must be a high calibre graduate with excellent 3GL (eg. 'C’) or 4GL (any) skills 
combined with strong communication skills. 


BUCKS £18k - £26k 
Revolutionary developer of emulation software products is seeking software and 
senior engineers with 2+ years in-depth experience of ‘C’, UNIX or MAC 
programming. Any MS-DOS, Assembler, Windows, PC device driver 
development, Workstations or RISC experience useful. 


CITY £20k - £25k + cheap mortgage! 
UNIX systems development, support and administration posts available if you 
have UNIX and ‘C’ skills combined with some of the following: C++, Ethernet, 
TCPAP, LAN Manager or Sybase/RDBMS. Vory wide ranging job in this leading 
financial organisation so flexible attitude to work and team approach needed, 


MIDDX £neg 
Developer of Project Management Software is seeking an experienced 
Analyst/Programmer to lead a team developing GUI toolkits and applications. 
Knowledge of ‘C’, writing Widgets combined with UNIX and MS-DOS is required. 
Any Oracle RDBMS and SQL desirable. 


WILTS £18k - £25k+ 
Project Manager and Senior Software Engineer required to develop exciting new 
Office Automation product if you have ‘C’ with UNIX plus either MS-WINDOWS. 
development, Microsoft SDK or Oracle database development. 


W.MIDLANDS to £20k + OT 
Point of Sale and back office software development project requires software 
engineer with 4 years + experience of ‘C’ under MS-DOS. Any of the following 
useful: Requirements Definition, WAN's, HDLC, Novell, ArcNet, ISAM, Ctree, 
or Rtree, 


LINCS £15k - £18k 
Design and development for bespoke software for publishing industry if you have 
‘C’/MS-DOS with some of: Graphics, GUI's, RDBMS, Comms, Networking or 
Assembler. 


W.Yorks £15k - £20k 
Specialist producer of Spatial Information Systems incorporating maths modelling, 
relational databases and graphics is seeking software engineers with ‘C’ and 
Windows 3 experience. . 


For further information about these and MANY 
other opportunities either telephone 
071 371-8496 
or write to: ACUMEN SEARCH & 
SELECTION INTERNATIONAL 
EBC House, 1a Ranelagh Gdns,London SW6 3PA 
Fax: 071-371 8502 Eves: 081 780 0636 


SUPERBASE 


Developer Support Engineer 


Interfacing between product and application 
developers, you will provide in-depth technical and 
programming support to both corporate and third 
party organisations. Additionally you may also have 
the opportunity to work on a variety of internal 
development projects. With a proven background in 
PC database development using 3/4GL tools, you 
will offer a detailed understanding of DOS and 
Windows internals and ideally other PC OS's, 
networks and SQL. 


Motivation towards self improvement, the ability 
to communicate effectively both in writing and orally 
and to integrate into a small multinational team is 
essential. 

As a major international PC software products 
company, SPC offer first rate opportunities for career 
progression internationally, together with a highly 
competitive salary and benefits package, job security 
and excellent working conditions. 


To register your interest please cal! 
Prospect International Ltd, Arlette House, 143 Wardour 


“PUBL 


SPC is one of the world's top 
5 PC software companies and a 
market leader in Windows 
applications. The company has 
grown dramatically since setting 
up international headquarters in 
Bracknell in 1989 and is now 
established in France, Belgium, 
Germany, Sweden, Italy and 
Holland. The recent acquisition 
of Precision Software has added 
an exciting new product to SPC's 


portfolio: Superbase 4 - the 
leading forms design, application 
development and _ relational 
database management software 
product for the Windows 
environment. 


| or fax your CV today to Stephen Dring at 
Street, London WIV 37B.Tel 071 439 1919.Fax 071 437 1791. 


Prospect 


‘Cc’ and MSWINDOWS 
Camberley to £19,000 
This company require an MSWINDOWS programmer (min 6 months 
Windows plus 1 years ‘C’) to work on the development of their Graphical 
User Interface development environment. You will be working in a small 
team where what you do counts! 

MULTI-MEDIA 
Surrey £12,000 to £20,000 
We have anumber of clients seeking dynamic young Programmers to work 
in the exciting arena of CD-| and MultiMedia development. Ideally you 
should possess an interest in Video or Music coupled with solid 
programming skills in ‘C’. 
C++ 

Middlesex £20,000 to £25,000 
This company need five Analysts and Senior Programmers with a minimum 
of one years C++ under UNIX. Experience of Communications, On-Line 
Transaction handling of User Interfaces is a bonus. 


COMPILER DESIGNER 
North West to £18,500 


We have a requirement for a Compiler Specialist with experience of the 
design and development of compilers. linkers and assemblers. Exposure 
to a wide variety of languages and operating systems including an 
assembly language and either UNIX or MS-DOS is essential. 


ANALYST PROGRAMMER 
Thames Valley to £15,000 


An opportunity for a recent graduate (1990 - 1992) with ‘C’ and UNIX to 
travel the world! A foreign language would be useful (Spanish ideal) but is 
not a prerequisite. 


‘C’/UNIX (Any Database) 
Cambridge (Any ) to £22,000 


This rapidly expanding Systems house are urgently seeking 
Analyst/Programmers and Programmers with a background in UNIX and 
‘C’ coupled with either of INGRES, ORACLE or SQL. 


VISION specialise in the technical, scientific, research and development 
areas of the computer industry. In addition to the opportunities listed 
opposite we continually seek computer professionals for vacancies at all 
levels of responsibility and technical experience for a broad cross-section 
of client companies. If your experience matches any of the following areas 
we will probably be able to help you find your next position. 


XWINDOWS MSWINDOWS SDK 


PRESENTATION MANAGER GRAPHICS MUSIC 


MULTI-MEDIA VIRTUAL REALITY VIDEO 


UNIX KERNAL DEVICE DRIVERS REAL-TIME 


C++ c OOPS 


ORACLE INGRES GUPTA-SQL 


UNIX MS-DOS os/2 


To discuss your individual requirements please contact us on the number 
below, alternatively forward a copy of your CV with details of a convenient 
time for us to contact you. 


ViSiON Computer Recruitment Ltd, 
70A High Street, Stony Stratford, Milton Keynes, MK11 1AH 


Tel: (0908) 260910 Fax: (0908) 260098 
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ADVERTISER PRODUCT/SERVICE CIRCLE PAGE | ADVERTISER 
Admiral Application Builder 139 76 POET 

Applied Logic Object Oriented Programming 126 60 Polyhedron 

Bits per Second Graphics for dBASE 113 46 Positive 

BL Security Security Dongle 145 87 (| QAL 

Blink Inc. Clipper Fast Linker 108 30 «| QAll 

Borland! Borland C++ 092 IFC/1 | QBSI 

Borland Il Borland C++ 104 23 QBSII 

Brent Communications MAX Copy Protection 135 n QBS Ill 

CTL Copy Protection Hardware 134 vA QBSIV 

Dataflex Development Tools 118 37 Readmar 

DES Software Protection 115 41 Real Techniques & Methods 
Facts Direct FAX Service 109 25 Recital 

Forté Version Control 111 35 Richfords 

Four Seasons Programming Tools 121 53 Ridgeway 

Grey Matter Programming Tools 094 5 Salford Software 
qwi Software Design Tools 150/152 5 Softlok 

Inmark C++ Application Framework 101 19 Software Con Co. | 
Inst. Analysts/Progmrs Institute 125 60 Software Con Co. II 
Intasoft Software Management System 110 35 Software Con Co. Ill 
Isv Marketing Newsletter 112 40 Software Paradise 
LPA AI/KB/OOPS Software 131 86 Software Security 
Magic Development Tool 100 7 STC 

Magnifeye Software Protection Device 105 24 Symantec 
Microcosm Copy Control 130 86 Symicron 
Microsoft! Developer News 097 1 System C 
Microsoft Il C/C++ Compiler 098 12/13 | System Science 
Microway Compilers 103 16 User Friendly 

Nu Mega Debugging Tools 106 27 Zinc 


PRODUCT/SERVICE CIRCLE PAGE 
Poet/Object Oriented Database 093 2 
Programmers Utility 137 rh) 
Editor 124 58 
Evaluator/Software Testing 117 45 
Training 146 OBC 
Clipper 147 46 
Clipper 122 54 
Clipper 128 64 
Clipper 144 83 
Version Control 096 8 
CASE for Windows. 102 21 
Seminars 120 51 
Training 095 7 
Computer Manuals & Binders 138 5 
Fortran for DOS & UNIX 140 7 
Piracy Protection 142 80 
Programming Tools 116 43 
Programming Tools 119 49 
Programming Tools 123 57 
Development Tools 127 61 
Security Products 099 14 
Development Package 132/133 69/70 
Zortech C++ 107 29 
Connectivity 136 4 
Application Generator 114 38 
Programming Tools 141 9 
Software Copy Control 143 82 
GUI Library 129 67 


STOB - FLGMJLLGHQ 


In which Ms Stob discovers that her life has been taken over. 


I wake up, and I’m hot and sweating, 
and the alarm clock radio says AM9 : OE, 
which is how it has portrayed 2.08am ever 
since a couple of its LED segments failed. 
Insomnia on a warm summer night: one of 
my favourite things, together with kittens 
and brown paper parcels tied up with string. 
Nothing for me here but the long, dreary, 
sticky wait for dawn and sweet exhaustion. 

But, hold up, there’s something moving. 
A panel has opened in the ceiling, a line of 
luminous little figures, like little men, each 
a couple of inches high, is dropping out 
onto the shelf. (If you are wondering about 
the high quality of animation in this dream 
sequence, by the way, it was done by the 
same people that did Roger Rabbit). Now 
the front of the column has dropped onto 
the duvet, and is marching up the bed to- 
wards my head. Now the front figurine is 
standing on the pillow, his feet among my 
golden tresses. Now he has produced a 
miniature pickaxe, its razor sharp point spar- 
kling green-ly in the glow of the clock, and 
is aiming a tremendous blow at my face... 

I woke up properly then, and everything 
was the same as before, except clock now 
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said *'7 : 42, Cautiously clambered over 


sleeping-snoring Loved One, shuffled 
through toe-stubbing darkness to kitchen, 
treated myself to a glass of greasy, bitter, 
blood-temperature Thames Water water, 
sat down on kitchen chair to take the 
weight off my adjectives. 

Lemmings is the name of the game, and 
if you haven't already encountered it, this 
probably isn’t going to make a lot of sense. 
It came into my life a month ago, as an 
innocent substitute for listening to Dave 
and Phil talk motors through the lunch 
hour, The scenario is simple: you guide a 
column of the things, which march nose-to- 
tail like the ants in Tom and Jerry, across a 
sequence of garish landscapes. Unlike 
T&J’s ants, which were indestructible, 
Lemmings are emphatically unindestruc- 
tible, forever blowing up, falling off cliffs 
into boiling oil etc. Ifyou don’t save enough 
of them, you lose, and get to go on playing 
Lemmings. If you do save enough of them, 
you win, and get to go on playing Lemm- 
ings. For the true addict, like myself, there 
is no pleasure in playing, there is just the 
relentless pressure (which motivates the 


Lemmings themselves) to move ever on- 
ward to the next screen. 

So after I had been skipping lunch, and 
pub-time, for a few weeks; and had lost the 
ability to concentrate on programming (what 
if 1 turn him into a blocker? could I release 
him later on by tunnelling underneath?); 
and my social life had become comparable 
to Rudolph Hess’s; after I had struggled to 
level 103 of 120, and could look forward to 
areturn to humanity in the near future, what 
happened? Some git in the office bought the 
sequel entitled, I believe, More Bloody Lemm- 
ings, and now I'm only at level 102 of 220. 
And then I thought: use the pickaxe first 
- I've dreamt the answer. So of course, I 
had to try it out at once. Which is how you 
came to find me, Officer, at 4am ona Friday 
morning, dressed in my night attire, trying 
to break into my place of work. Of course 
I'll come quietly. If 1 could just have a few 
moments alone with this PC... 
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Verity Stob was reviewing ‘Lemmings’ and ‘OH 
NO! More Lemmings’, published by Psygnosis 
Lid (051 709 5755) at around £30 each. 


UP TO £30K 


N.LONDON 
A PC driven Market Research Information Systems 
house is looking for another member for an excellent 
design team. The company is heavily committed to de- 
velopment under Windows, and is keen to exploit new 
technologies - Multi-Media, database engines etc. En- 
thusiasm and Commitment are essential ingredients! 


SYBASE - ORACLE - UNIFA\ 


UP TO £30K 
This consultancy has lots of commercial work on at the 
moment and has urgent needs for any good database 
applications people - either PC LAN/WAN based or 
UNIX based. The work is varied and interesting - it is 
envisaged that there will be lots of travel - if you want 
to do a roving consultancy role, but it is up to you. 


WINDOWS - OMNIS - 
GUI -C-SQL 


SUFFOLK £25K+ 
A fantastic rural setting: and an influential UK Software 
House with a worldwide success is looking for a "really 
special" Windows developer. | think that all your experi- 
ence that is considered valuable should be applications 
driven rather than product driven; but as long as your 
Windows skills are excellent and your C fluent | won't 
be that concerned! 


Oat OS 
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CAMBS £20K + BENS 
A multi-national company with a good development 
reputation, is moving all its critical applications to RISC 
based UNIX systems - it is envisaged that all database 
applications will be moving to Sybase as well - so that 
lucky recipient will have very useful skills to build their 
career with - lots and lots of company benefits as well. 


TAS 


HOME COUNTIES UP TO £30K 
One of the top four software/systems Integration Com- 
panies is seeking a specialist urgently - it is envisaged 
that a minimum of five years of experience is a 
necessity - but some applications work would be of 
benefit as would translator/compiler skills. 


Re 
» 4 


have just the right vacancy for you! 


DURNAN LINSTEAD & ASSOCIATES 
32 ST JAMES’ STREET, LONDON SW1A 1HT 


MIDDX/SURREY 


£25K + BENS 
An expert system shell company is looking for an OS/2 
specialist; they produce an applications development 
tool as well - all the handling is using SQL and APPC. 
You should be aware of Windows SDK, have good C 
and be interested in GUIs and multi-product interfacing. 
An exacting and exciting role 


LONDON £GOOD 
One of the top OOL/OOD Software houses is intent on 
building its development expertise further - you will be 
expected to have good C, GUI experience and be able 
to communicate your skill and enthusiasm to potential 
and existing clients - you must have at least one major 
SMALLTALK V development under your belt. 


| | N 


NINE 


HOME COUNTIES 
You should be aware of Windows/Database applica- 
tions and their emulation possibilities to host - the 
Client-server mentality is called for here - lots of differ- 
ent operating systems required - MVS - AS400 - DEC 
VAX - UNIX etc - you should have moved from C cod- 
ing into Comms and Connectivity. Any areas of 
weakness will be trained Possible travel to USA. 


CAMBS/HERTS UP TO £25K 
Are UNIX graphical interface applications your thing? If 
so, then | think that this company should be able to 
offer you some considerable development experience, 
be prepared to interface with SYNOS - MSDOS - OS2 
otherwise you could be in for a shock... 


BUCKS/BERKS UP TO £24K 
A product Consultancy role is up for grabs - talking to 
Applications developers - helping them tune their sys- 
tems development. You should have come from a 
C/Windows/Database background and be looking to 
move out of development into Consultancy. Good 
career prospects. 


in, 


If any of the above vacancies do not quite suit you, why not give us a call and we might 


For any further information and applications, please call Mike Dearing or Simon Gudigeon 
on 071 321 2277, or after business hours and weekends on 0376 348469, alternatively fax 


your C.V. on 071 925 2150. 


Introducing the First 
Complete Education Programme in 


G@-» 


Object-Oriented © 
Technology 


I properly implemented the benefits of object 
technology to software developers can be 
immense, but as an 


emergent technology 


deliver the benefits. 


The cornerstone of our 


management-level Stra 
benefits of OOT and 
implement projects. A 
will be involved in OOT decision making. 
Alternatively, yo' i lay prefer to begin with 
the Primer course, a tech: intro- 
duction to OOT and an excellent —_ 
first step toward both 
the Design and Analysis courses. 

2 An integral part of our 
OOT programme is that 


for C++, one of the 


Tick here for details: 


Mail to QA Training Ltd, Cecily Hill Castle, Cirencester, Gloucestershire GL7 2EF, UK. 


industry's most popular implementation 


languages to achieve your Object-Oriented goals. 


As a result of our total commitment to OOT 
and the considerable 
expertise we have 
ow developed in 


company may prefer 


to explore and 
develop its commer- 
cial opportunities 


through our consultancy service. 


To obtain full details of 
our carefully structured 
courses and consultancy in 

this new technology, which is set to revolutionise 
the world of software development, simply tele- 
phone Samantha Trinder on 0285 655888 or 


return the coupon. 


TRAINING: Object-Oriented 


Unix/Aix 


Networks OS/2 Windows Cc 


CONSULTANCY 


SOFTWARE DEVELOPMENT PRODUCTS 


TRAINING 


First for Object-Oriented Education 


NAME TITLE 
COMPANY 
ADDRESS 

TEL. NO. 
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